10分钟上手DevEco Testing:编写你的第一个HarmonyOS5单元测试

单元测试是保障代码质量的核心环节。本文将带你快速掌握在HarmonyOS中使用DevEco Testing编写单元测试的方法,只需10分钟即可完成第一个测试用例!


一、环境准备

  1. 开发工具
  • DevEco Studio 5.0.4+
  • HarmonyOS SDK 5.0.0+
  1. 工程配置build-profile.json5中添加测试依赖:
json 复制代码
"dependencies": {
  "unitTest": {
    "compileOnly": true,
    "runtimeOnly": true
  }
}

二、创建第一个测试用例

示例场景:日期工具类测试

假设有日期处理工具DateUtils.ets

typescript 复制代码
// DateUtils.ets
export class DateUtils {
  static isSameDay(date1: Date, date2: Date): boolean {
    return date1.getFullYear() === date2.getFullYear() &&
           date1.getMonth() === date2.getMonth() &&
           date1.getDate() === date2.getDate();
  }
}

单元测试代码

src/test/ets/DateUtils.test.ets中编写测试:

typescript 复制代码
import { describe, it, expect } from '@ohos/hypium'; // 测试框架
import { DateUtils } from '../main/ets/utils/DateUtils';

describe('DateUtilsTest', () => {
  it('testIsSameDay_positive', 0, () => {
    const date1 = new Date(2025, 5, 9); // 6月9日
    const date2 = new Date(2025, 5, 9);
    expect(DateUtils.isSameDay(date1, date2)).assertTrue();
  });

  it('testIsSameDay_negative', 0, () => {
    const date1 = new Date(2025, 5, 9);
    const date2 = new Date(2025, 5, 10);
    expect(DateUtils.isSameDay(date1, date2)).assertFalse();
  });
});

三、运行与解读测试

  1. 执行测试 右键点击测试文件 → 选择Run 'DateUtilsTest'
scss 复制代码
[RESULT] DateUtilsTest
  ✓ testIsSameDay_positive (3ms)
  ✓ testIsSameDay_negative (1ms)
  1. 测试报告
  • 绿色对勾:测试通过
  • 代码覆盖率:在Run面板点击Show Coverage Data查看
  • 失败定位:直接跳转到断言失败的行

四、高级测试技巧

  1. Mock外部依赖 使用@ohos/hypium的mock功能隔离网络请求:
typescript 复制代码
import { mock } from '@ohos/hypium';

const mockFetch = mock(globalThis, 'fetch', async () => {
  return new Response(JSON.stringify({ data: "mock" }));
});
  1. 异步测试 处理Promise返回值:
typescript 复制代码
it('testAsync', async () => {
  const result = await fetchData();
  expect(result).assertEqual("expected");
});

五、最佳实践

  1. 测试规范
  • 测试类名:被测试类名 + Test
  • 测试方法:test_方法名_测试场景
  • 覆盖率目标:核心逻辑 ≥80%
  1. 常见问题
  • 依赖缺失 :在oh-package.json5中确认@ohos/hypium版本
  • API兼容:确保测试设备API≥9

结语

通过本文,你已掌握了HarmonyOS单元测试的核心流程。持续编写单元测试能显著提升代码健壮性,减少线上故障。下一步建议:

  1. 为复杂业务模块添加测试
  2. 配置持续集成自动运行测试
  3. 探索UI测试框架UiTest

环境说明:本文示例基于HarmonyOS 5.0.0+,DevEco Studio 5.0.4+

相关推荐
新world8 小时前
mybatis-plus从入门到入土(二):单元测试
单元测试·log4j·mybatis
仰望星空@脚踏实地1 天前
Spring Boot Web 服务单元测试设计指南
spring boot·后端·单元测试
啃火龙果的兔子3 天前
前端单元测试覆盖率工具有哪些,分别有什么优缺点
前端·单元测试
编程乐学(Arfan开发工程师)13 天前
75、单元测试-嵌套测试
前端·javascript·redis·python·单元测试·bootstrap
编程乐学(Arfan开发工程师)13 天前
73、单元测试-断言机制
服务器·数据库·servlet·单元测试·sqlite·log4j·mybatis
编程乐学(Arfan开发工程师)13 天前
74、单元测试-前置条件
redis·python·阿里云·单元测试·云计算·bootstrap
不一样的少年_13 天前
前端单元测试的救星:Vitest 输入和 Mock 技术详解
前端·单元测试
十连满潜13 天前
springboot集成mockito和jacoco实践
后端·单元测试·mockito
bo5210016 天前
vue3单元测试-项目实战
vue.js·单元测试
bo5210017 天前
vue3单元测试-初步了解
vue.js·单元测试