如何使Jest的toMatchSnapshot抛出异常？快照失败检测方法

首先明确一点：toMatchSnapshot()确实无法被配置为直接抛出异常。这是Jest的设计逻辑——它会把所有快照不匹配的情况统一收集起来，等到整个测试套件运行结束后再一起报告，而不是在断言执行时立刻抛出错误打断测试流程。

不过，如果你需要在测试中主动检测快照是否匹配失败，或者实现类似“失败即中断”的效果，有几种可行的方案：

方案1：利用Jest内部状态检查测试结果 #

你可以通过expect.getState()获取当前测试的执行状态，在测试钩子（比如afterEach）里检查是否有快照失败的信息，必要时主动抛出自定义异常。示例代码如下：

afterEach(() => {
  const currentTest = expect.getState().currentTestResults;
  // 检查当前测试是否有失败的断言（包括快照不匹配）
  if (currentTest.failureMessages.length > 0) {
    // 这里可以根据需求处理，比如抛出异常中断后续测试
    throw new Error(`快照匹配失败: ${currentTest.failureMessages.join('\n')}`);
  }
});

test('验证用户信息快照', () => {
  expect.hasAssertions(); // 确保断言被执行
  expect({ name: 'Alice', age: 30 }).toMatchSnapshot();
});

注意：expect.getState()是Jest的内部API，可能会随着版本更新发生变化，使用时需要留意兼容性。

方案2：封装自定义快照断言 #

通过expect.extend创建一个自定义断言，在内部处理快照匹配逻辑，当不匹配时主动抛出异常。示例：

expect.extend({
  toMatchSnapshotAndThrow(received, snapshotName) {
    // 调用Jest内部的快照匹配逻辑
    const snapshotState = this.snapshotState;
    const matchResult = snapshotState.match(received, snapshotName);
    const { pass, message } = this.utils.equals(received, matchResult);

    if (!pass) {
      // 主动抛出异常
      throw new Error(message());
    }

    return { pass, message };
  }
});

test('自定义快照断言测试', () => {
  expect({ foo: 'unexpected-value' }).toMatchSnapshotAndThrow();
});

这种方式同样依赖Jest的内部实现细节，需要注意版本兼容性。

方案3：使用命令行参数快速中断测试 #

如果你只是希望只要有一个快照失败就立刻停止整个测试流程，可以在运行Jest时加上--bail参数：

jest --bail

这样Jest会在第一个失败的测试（包括快照不匹配）出现时立刻终止运行，达到类似“失败即中断”的效果。

方案4：手动读取并对比快照文件 #

如果你的场景比较特殊，也可以直接读取快照文件的内容，和当前测试值手动对比，不匹配时抛出异常。示例：

const fs = require('fs');
const path = require('path');

test('手动对比快照', () => {
  const receivedData = { username: 'bob', email: 'bob@example.com' };
  // 拼接快照文件路径
  const snapshotFile = path.join(__dirname, '__snapshots__', 'my-test.test.js.snap');
  const snapshotContent = fs.readFileSync(snapshotFile, 'utf8');

  // 从快照文件中提取对应测试用例的快照数据
  const snapshotMatch = snapshotContent.match(/exports\[`手动对比快照`\] = (.*);/);
  if (!snapshotMatch) {
    throw new Error('未找到对应快照');
  }
  const expectedData = JSON.parse(snapshotMatch[1]);

  // 手动对比
  if (JSON.stringify(receivedData) !== JSON.stringify(expectedData)) {
    throw new Error('快照不匹配！');
  }
});

这种方式比较繁琐，需要自己处理快照的解析和维护，适合一些特殊的测试场景。

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