hitode909/backstop-retry-failed-scenarios

backstop-retry-failed-scenarios

BackstopJS的包装命令，用于重试失败的测试场景。它会解析report.json文件，提取失败的测试用例，通过--filter选项重新运行，并改写结果文件。这在测试不稳定时非常有用。

核心功能

• 调用指定的测试命令
• 从失败测试生成过滤选项
• 重组各失败报告至最新状态（支持HTML报告、JSON报告、CI报告）

使用场景

• 当测试不稳定，部分用例偶尔失败时，自动重试失败用例以提高通过率
• 参考环境为生产、测试环境为 staging 时，重新生成失败用例的参考文件后再重试

示例

以下端点会随机返回三个表情符号（😀、😇、😝），每次尝试可能失败，但重试失败测试后可全部通过：
[***]

bash
$ cd examples/retry
$ backstop reference
$ npx backstop-retry-failed-scenarios

运行方式

替代backstop test，运行backstop-retry-failed-scenarios并设置命令、重试次数、配置路径：

本地安装方式

bash
$ npm install -g backstop backstop-retry-failed-scenarios
$ backstop init
$ backstop reference
$ backstop-retry-failed-scenarios --retry 5 --command 'backstop test' --config backstop.js

Docker部署方式

可从DockerHub拉取镜像（基于backstopjs/backstopjs）：

bash
$ docker pull hitode909/backstop-retry-failed-scenarios
$ docker run --rm -v $(pwd):/src hitode909/backstop-retry-failed-scenarios backstop init
$ docker run --rm -v $(pwd):/src hitode909/backstop-retry-failed-scenarios backstop reference
$ docker run --rm -v $(pwd):/src hitode909/backstop-retry-failed-scenarios backstop-retry-failed-scenarios

若需每次重新创建参考文件，可设置--reference-command选项：

1. 创建所有参考文件
2. 运行所有测试
3. 为步骤2中失败的测试创建参考文件
4. 重新运行步骤2中失败的测试

bash
$ backstop init
$ backstop-retry-failed-scenarios --reference-command 'backstop reference' --command 'backstop test' --config backstop.js

选项说明

  --retry             重试次数，默认：2（运行1次+重试1次），最小值：2
  --config            配置文件路径，默认：backstop.json
  --command           测试命令，默认：backstop test
  --reference-command 测试前创建参考文件的命令，默认：null（不创建）
  --output-profile    性能分析输出文件路径，若指定则测量执行时间并输出JSON报告