当前位置：首页 > news >正文

HarmonyOS7 单元测试：从 @Test 到覆盖率

news 2026/7/17 7:17:53

文章目录

- 前言
- 先有一个被测函数
- - 代码实现
- 写测试文件
- - 核心代码
- 怎么跑测试
- - 完整示例
- 测试异步代码
- - 代码解析
- 看覆盖率
- 常见误区（小白必踩）
- 完整可运行示例：单元测试
- - 实现拆解
- 写在最后

前言

“我改了一行，不知道会不会弄坏别的功能”——这是没测试的噩梦。单元测试就是给代码买保险：你写个小测试，验证"这个函数输入 A 应该输出 B"，以后谁改坏了立马红。

HarmonyOS 用@ohos/hypium测试框架。这篇文章从零写一个测试，讲清@Test、断言、怎么跑、怎么看覆盖率。

先有一个被测函数

测试的前提是：你要测的代码是"纯函数"或可独立调用的。比如一个工具：

代码实现

// utils/Calc.etsexportfunctionadd(a:number,b:number):number{returna+b}exportfunctionisEven(n:number):boolean{returnn%2===0}

写测试文件

测试文件一般放在src/test/下，用describe/it组织，用@Test标注用例：

核心代码

import{describe,it,expect}from'@ohos/hypium'import{add,isEven}from'../utils/Calc'exportdefaultfunctioncalcTest(){describe('Calc 测试',()=>{it('add 两数相加',0,()=>{expect(add(1,2)).assertEqual(3)})it('isEven 偶数判断',0,()=>{expect(isEven(4)).assertEqual(true)expect(isEven(3)).assertEqual(false)})})}

讲解：

describe('Calc 测试', ...)：测试套件名，分组用。
it('用例名', 0, () => {...})：单个测试用例，0是用例标记位。
expect(x).assertEqual(y)：断言，x 应该等于 y，不等就测试失败。

断言方法还有assertTrue、assertClose（近似相等）、assertFail等，按场景选。

怎么跑测试

在 DevEco 里，右键测试文件 → “Run ‘xxxTest’”，或用命令行。跑完会显示每个用例过没过：

完整示例

Calc 测试 ✓ add 两数相加 ✓ isEven 偶数判断 2 passed, 0 failed

红的就是要修的。测试的价值就在这一刻：改坏代码，立刻红给你看。

测试异步代码

涉及 Promise 的，用async/await：

代码解析

it('异步请求返回数据',0,async()=>{constres=awaitfetchUser(1)expect(res.id).assertEqual(1)})

看覆盖率

覆盖率告诉你"测试覆盖了多少代码行"。DevEco 开启覆盖率后，会标出哪些行没被测到（红色），提示你补用例。

行覆盖率：多少行代码被执行过。
分支覆盖率：if/else 各分支是否都测了。

目标不必 100%，但核心逻辑（计算、校验、状态机）尽量覆盖到。

常见误区（小白必踩）

误区	说明
只测主流程不测边界	`add(1,2)`过了就以为没问题，负数、空值、超大数才是容易出错的。
异步不`await`	测试 Promise 忘了`async/await`，用例直接过但啥也没验。
不看覆盖率	覆盖率告诉你哪些行没测到，红的那几行往往就是 bug 藏身处。

下面这段代码可以直接复制到 DevEco Studio 里运行。建议你边读边敲，改一改文末「动手改一改」里的参数，亲眼看看效果。

完整可运行示例：单元测试

用@Test验证一个纯函数。

实现拆解

// 用 Hypium 写单元测试import{describe,it,expect}from'@ohos/hypium'functionadd(a:number,b:number):number{returna+b}exportdefaultfunctiontestSuite(){describe('math',()=>{it('add 应该返回两数之和',0,()=>{expect(add(1,2)).assertEqual(3)})})}