SuperAPI AI 工具集

insta-snapshots

测试与质量

查看项目

更新于 10-16 03:14

技能介绍

用途:在预期输出变化或快照测试失败后,非交互地审查并更新 Oxc 的 Insta 快照。

主要能力与用法:先运行受影响的测试以生成待定快照,再用 cargo insta pending-snapshots 读取旧的 .snap 与新的 .snap.new 输出,逐个判断变更是否符合预期行为。应使用 CLI,而非交互式 cargo insta review UI 或手动编辑预期输出:运行 cargo insta pending-snapshots,再用 cargo insta accept --snapshot <snapshot_name> 接受单个快照。接受范围仅限本次任务中已审查的快照;若名称或包过滤不明确,可查看 cargo insta accept --help。存在无关待定快照时,避免工作区范围的接受或拒绝。若输出不符合预期,应先修复实现再接受。

接受后,检查快照 diff 并重新运行受影响的测试。结束时应有预期的 .snap 更新,且没有任务生成的 .snap.new 文件残留。更新快照本身不要求提交。

限制:快照记录预期输出,某些 crate 也包含成功输出。Linter 诊断快照位于 crates/oxc_linter/src/snapshots/,其他 crate 各有位置。Conformance .snap.md 报告使用单独的更新机制,应检查产生它的测试 harness,而不能当作 Insta 待定快照处理。