鸿蒙开发之如何使用mock对HTTP的回调进行本地测试

如何使用mock对HTTP的回调进行本地测试

在进行HTTP回调的本地测试时，使用mock技术可以帮助我们模拟HTTP请求和响应，从而在不依赖真实网络环境的情况下进行测试。以下是一些关键步骤和知识点，帮助你实现这一目标。

创建本地测试用例

1. 创建测试类：

   • 在工程目录下打开待测试模块（支持HAP、HAR、HSP模块）下的ets文件。
   • 将光标置于代码中任意位置，单击右键 > Show Context Actions > Create Local Test 或使用快捷键Alt+enter > Create Local Test。

2. 配置测试参数：

   • 在弹出的Create Local Test窗口中，输入或选择如下参数：
     • Testing library：测试类型，默认为DECC-ArkTSUnit。
     • ArkTS name：创建的测试套件名称，要求在工程目录范围内具有唯一性，仅支持字母、数字、下划线（_）和点（.）。
     • Destination package：测试套件存放的位置，建议存放在待测试模块的test目录下。

3. 生成测试类：

   • DevEco Studio会在test目录下自动生成对应的测试类，并生成对应方法的用例模板。具体测试代码需要开发者根据业务逻辑进行开发。

运行本地测试用例

1. 运行模式：

   • 可以采用运行工程目录（test）、测试文件（如Index.tets.ets）、测试套件（describe）、测试方法（it）的方式来执行Local Test。
   • 以文件级别为例，在工程目录中，选中文件，单击右键 > Run ‘测试文件名称’。

2. 调试模式：

   • 调试模式相比运行模式增加了断点管理功能。
   • 在添加断点之后，在工程目录中，选中文件，单击右键 > Debug ‘测试文件名称’。

3. 覆盖率统计模式：

   • 在LocalTest运行的基础上支持代码覆盖率统计，当前仅支持ArkTS工程。
   • 以文件级别为例，有两种方式启动测试：
     • 方式一：在工程目录中，选中文件，单击右键 > Run ‘测试文件名称’ with Coverage。
     • 方式二：在DevEco Studio的右上角，选择测试任务，然后单击右侧的按钮，执行测试。

自定义测试用例运行任务（可选）

1. 编辑配置：
   • 在工具栏主菜单单击Run > Edit Configurations，进入Run/Debug Configurations界面。
   • 单击+按钮，在弹出的下拉菜单中，单击Local Test。
   • 根据实际情况，配置Local Test的运行参数，然后单击OK，完成配置。

使用命令行执行Local Test

1. 命令行执行：
   • 通过命令行方式执行Local Test：

     hvigorw test -p module={moduleName} -p coverage={true} -p scope={testSuitClass#testCase}
     

   • 参数说明：
     • module：执行测试的模块。不填写-p module表示执行所有模块。
     • coverage：是否生成覆盖率报告，默认是true。
     • scope：既可以执行测试套，可以指定单个测试用例。不填写-p scope表示执行所有的测试套。

代码示例

以下是一个简单的示例，展示如何使用mock对http的回调进行本地测试：

// 假设我们有一个HTTP请求函数
async function fetchData(url) {
  const response = await fetch(url);
  return await response.json();
}

// 使用jest进行测试
test('fetchData should return data from API', async () => {
  // 使用jest的mock函数模拟fetch
  global.fetch = jest.fn(() =>
    Promise.resolve({
      json: () => Promise.resolve({ data: 'mock data' }),
    })
  );

  const data = await fetchData('https://example.com/api');
  expect(data).toEqual({ data: 'mock data' });
});

在这个示例中，我们使用jest的mock函数来模拟fetch请求，并验证fetchData函数是否返回了预期的数据。

参考链接

• [A1.1] Local Test: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-local-test-0000001853634485-V5