【OpenHarmony】 ArkTS 语法基础 ② ( ArkTS 自定义组件 )

<div style="text-align: center;font-size: xxx-large" >Hypium</div> <div style="text-align: center">A unit test framework for OpenHarmonyOS application</div> ## Hypium是什么? *** - Hypium是OpenHarmony上的测试框架，提供测试用例编写、执行、结果显示能力，用于OpenHarmony系统应用接口以及应用界面测试。 - Hypium结构化模型：hypium工程主要由List.test.js与TestCase.test.js组成。 ``` rootProject // Hypium工程根目录 ├── moduleA │   ├── src │      ├── main // 被测试应用目录 │      ├── ohosTest // 测试用例目录 │         ├── js/ets │            └── test │               └── List.test.js // 测试用例加载脚本，ets目录下为.ets后缀 │               └── TestCase.test.js // 测试用例脚本，ets目录下为.ets后缀 └── moduleB ... │               └── List.test.js // 测试用例加载脚本，ets目录下为.ets后缀 │               └── TestCase.test.js // 测试用例脚本，ets目录下为.ets后缀 ``` ## 安装使用 *** - 在DevEco Studio内使用Hypium - 工程级package.json内配置: ```json "dependencies": { "@ohos/hypium": "1.0.7" } ``` 注： hypium服务于OpenHarmonyOS应用对外接口测试、系统对外接口测试（SDK中接口），完成HAP自动化测试。详细指导： [Deveco Studio](https://developer.harmonyos.com/cn/develop/deveco-studio) #### 通用语法 - 测试用例采用业内通用语法，describe代表一个测试套， it代表一条用例。 | No. | API | 功能说明 | | --- | ---------- | ---------------------------------------------------------------------------------------------------------------------- | | 1 | describe | 定义一个测试套，支持两个参数：测试套名称和测试套函数 | | 2 | beforeAll | 在测试套内定义一个预置条件，在所有测试用例开始前执行且仅执行一次，支持一个参数：预置动作函数 | | 3 | beforeEach | 在测试套内定义一个单元预置条件，在每条测试用例开始前执行，执行次数与it定义的测试用例数一致，支持一个参数：预置动作函数 | | 4 | afterEach | 在测试套内定义一个单元清理条件，在每条测试用例结束后执行，执行次数与it定义的测试用例数一致，支持一个参数：清理动作函数 | | 5 | afterAll | 在测试套内定义一个清理条件，在所有测试用例结束后执行且仅执行一次，支持一个参数：清理动作函数 | | 6 | it | 定义一条测试用例，支持三个参数：用例名称，过滤参数和用例函数 | | 7 | expect | 支持bool类型判断等多种断言方法 | #### 断言库 - 示例代码： ```javascript expect(${actualvalue}).assertX(${expectvalue}) ``` - 断言功能列表： | No. | API | 功能说明 | | :--- | :------------------------------- | ---------------------------------------------------------------------------------------------- | | 1 | assertClose | 检验actualvalue和expectvalue(0)的接近程度是否是expectValue(1) | | 2 | assertContain | 检验actualvalue中是否包含expectvalue | | 3 | assertDeepEquals | @since1.0.4 检验actualvalue和expectvalue(0)是否是同一个对象 | | 4 | assertEqual | 检验actualvalue是否等于expectvalue[0] | | 5 | assertFail | 抛出一个错误 | | 6 | assertFalse | 检验actualvalue是否是false | | 7 | assertTrue | 检验actualvalue是否是true | | 8 | assertInstanceOf | 检验actualvalue是否是expectvalue类型 | | 9 | assertLarger | 检验actualvalue是否大于expectvalue | | 10 | assertLess | 检验actualvalue是否小于expectvalue | | 11 | assertNaN | @since1.0.4 检验actualvalue是否是NaN | | 12 | assertNegUnlimited | @since1.0.4 检验actualvalue是否等于Number.NEGATIVE_INFINITY | | 13 | assertNull | 检验actualvalue是否是null | | 14 | assertPosUnlimited | @since1.0.4 检验actualvalue是否等于Number.POSITIVE_INFINITY | | 15 | assertPromiseIsPending | @since1.0.4 检验actualvalue是否处于Pending状态【actualvalue为promse对象】 | | 16 | assertPromiseIsRejected | @since1.0.4 检验actualvalue是否处于Rejected状态【同15】 | | 17 | assertPromiseIsRejectedWith | @since1.0.4 检验actualvalue是否处于Rejected状态，并且比较执行的结果值【同15】 | | 18 | assertPromiseIsRejectedWithError | @since1.0.4 检验actualvalue是否处于Rejected状态并有异常，同时比较异常的类型和message值【同15】 | | 19 | assertPromiseIsResolved | @since1.0.4 检验actualvalue是否处于Resolved状态【同15】 | | 20 | assertPromiseIsResolvedWith | @since1.0.4 检验actualvalue是否处于Resolved状态，并且比较执行的结果值【同15】 | | 21 | assertThrowError | 检验actualvalue抛出Error内容是否是expectValue | | 22 | assertUndefined | 检验actualvalue是否是undefined | | 23 | not | @since1.0.4 断言结果取反 | 示例代码： ```javascript import { describe, it, expect } from '@ohos/hypium'; export default async function assertCloseTest() { describe('assertClose', function () { it('assertClose_success', 0, function () { let a = 100; let b = 0.1; expect(a).assertClose(99, b); }) }) } ``` #### 公共系统能力 | No. | API | 功能描述 | | ---- | ------------------------------------------------------- | ------------------------------------------------------------ | | 1 | existKeyword(keyword: string, timeout: number): boolean | @since1.0.3 hilog日志中查找指定字段是否存在，keyw