如何让Detox仅在测试失败时截图并以测试名命名保存？

开发者阿泽

2026-7-24

Detox仅在测试失败时按测试名截图的实现方法

核心逻辑

Detox基于Jasmine或Mocha这类测试框架运行，在afterEach钩子中可以直接访问当前测试的状态与名称，以此实现失败时才截图的需求。

完整代码实现

afterEach(async function () {
  // 根据测试框架选择对应方式获取当前测试对象
  // Jasmine 环境用 this.currentTest，Mocha 环境用 this.test
  const currentTest = this.currentTest || this.test;

  // 仅在测试失败时执行截图操作
  if (currentTest?.status === 'failed') {
    // 清理测试名称中的特殊字符，避免文件路径异常
    const safeTestName = currentTest.fullName.replace(/[<>:"/\\|?*]/g, '-');
    const screenshotPath = `./${safeTestName}.png`;
    
    await device.takeScreenshot(screenshotPath);
  }
});

关键细节说明

测试元数据获取：Jasmine通过this.currentTest、Mocha通过this.test获取当前测试实例，其中包含status（测试状态，失败时为failed）和fullName（完整测试名称）。
名称格式化：用正则表达式替换测试名称中的特殊字符（如<、>、/等），防止生成无效的文件路径。
条件触发：只有当测试状态为failed时才调用截图方法，避免无意义的截图操作。