quarantine-test 面向测试与质量保障场景,用于在测试出现不稳定(flaky)问题时留下结构化的记录,而不是直接跳过或放宽检查。
用途:当某个测试的失败原因尚不明确时,用它把该测试登记到隔离清单中,同时保留可追溯的责任归属和证据,确保问题不会被悄悄忽略。
主要能力:
- 记录测试的精确文件路径与标题路径到 tests/quarantine.json。
- 为条目登记责任人、原因或证据、首次出现时间戳,以及七天内的修复或删除截止期限。
- 状态区分:investigating(调查中)与 known-failure(已知失败);使用 quarantined 状态时必须提供完整 SHA 和证据。
- 要求记录复现步骤与验收标准。
- 隔离条目不会豁免测试执行,也不会让质量门禁变为通过;断言与超时保持不变。
- 已解决的条目应被移除,而不是在文档中追加历史。
使用方式:
- 阅读 docs/testing.md 中关于 known-flaky-tests 的说明,以及 scripts/quarantine.ts。
- 优先从根源修复;若因果关系不明确,可在同一 SHA 上重跑失败测试一次,重复失败即视为真实问题,跳过用例不能证明任何事。
- 将条目写入 tests/quarantine.json,包含上述必要信息。
- 执行 pnpm exec prettier --write tests/quarantine.json 格式化文件。
- 执行 pnpm exec vitest run tests/quarantine.test.ts 进行校验。
适用场景:持续集成中出现的偶发失败测试管理、需要明确责任人与修复期限的测试治理流程。
限制:资料未说明该工具的收费、价格、支持平台或具体效果;其他未提及的事实暂未提供。