如何配置Jest在快照文件缺失时触发CI构建失败？

你可以通过以下几种实用方案解决这个问题：

方案1：结合Git状态检查 #

在CI构建脚本中，先运行常规测试，再检查Git是否有新增的快照文件——因为Jest生成缺失的快照后会创建新的.snap文件，而这些文件未被提交的话会出现在Git的未跟踪列表里。

示例CI脚本片段：

# 先执行Jest测试
jest

# 检查是否有新增的.snap文件
if git diff --name-only --diff-filter=A | grep -q "\.snap$"; then
  echo "错误：检测到未提交的快照文件，请提交后再运行构建！"
  exit 1
fi

如果检测到新增的快照文件，直接以错误码退出，终止CI流程。

方案2：自定义Jest结果处理器 #

利用Jest的testResultsProcessor配置，编写一个简单的脚本监听测试结果，判断是否有快照被新增：

1. 创建snapshot-checker.js文件：

module.exports = (testResults) => {
  const hasNewSnapshots = testResults.testResults.some(result => {
    return result.snapshot.added > 0;
  });

  if (hasNewSnapshots) {
    console.error("错误：发现新增的快照文件，未提交前无法通过CI！");
    process.exit(1);
  }

  return testResults;
};

2. 在jest.config.js中配置这个处理器：

module.exports = {
  // 其他配置...
  testResultsProcessor: './snapshot-checker.js',
};

这样Jest执行完测试后会自动检查，一旦有新增快照就直接报错退出。

方案3：使用快照验证工具 #

可以借助jest-snapshot-validator这类工具，它能在测试运行前检查所有测试用例引用的快照是否存在，缺失则直接抛出错误：

1. 安装依赖：

npm install jest-snapshot-validator --save-dev

2. 在全局测试setup文件（比如setupTests.js）中添加验证逻辑：

const validateSnapshots = require('jest-snapshot-validator');
validateSnapshots();

工具会自动扫描所有测试中的快照引用，发现缺失就立即终止测试，让CI构建失败。

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