如何使用detox测试框架生成端到端测试报告？

Detox 本身兼容 Jest 生态，同时支持专属自定义报告插件，以下两种方案均可以实现HTML报告生成：

方案1：结合 Jest + jest-html-reporter 生成 #

如果你的 Detox 测试使用 Jest 作为运行器，可直接复用 Jest 生态的HTML报告能力：

• 安装依赖：npm install jest-html-reporter --save-dev
• 修改 Jest 配置文件（通常为e2e/jest.config.js），新增报告器配置：

module.exports = {
  // 保留原有Jest配置内容
  reporters: [
    "default",
    [
      "jest-html-reporter",
      {
        pageTitle: "Detox E2E 测试报告",
        outputPath: "./reports/e2e-test-report.html",
        includeFailureMsg: true,
        includeSuiteFailure: true
      }
    ]
  ]
}

• 正常执行 Detox 测试命令，测试结束后会自动在配置的outputPath路径生成HTML报告。

方案2：使用 detox-html-reporter 专属报告器 #

该插件为 Detox 专属适配，支持插入失败用例截图、设备信息、执行日志等端到端测试专属字段：

• 安装依赖：npm install detox-html-reporter --save-dev
• 修改 Detox 配置文件（通常为.detoxrc.js），新增 artifacts 配置段：

module.exports = {
  // 保留原有Detox配置内容
  artifacts: {
    rootDir: "./artifacts",
    plugins: {
      html: {
        enabled: true,
        outputPath: "./reports/detox-e2e-report.html",
        includeScreenshots: true,
        includeLogs: true
      }
    }
  }
}

• 正常执行测试即可生成完整HTML报告，若配置中未开启enabled: true，可在运行测试时追加--record-html参数临时开启报告生成。

常见问题排查 #

• 若生成的报告为空，需确认运行器匹配：使用Jest运行测试时报告器必须注册在Jest配置中，使用Detox原生运行器则需把报告配置放在Detox的artifacts配置段。
• 若需要合并多轮测试的报告，可安装对应的合并工具，将多份单轮报告合并为一份汇总报告。

内容的提问来源于stack exchange，提问作者Vijay Seshadri