如何让Jest在出现未捕获的Promise拒绝时标记测试失败？

我完全懂你的痛点——这种未处理的Promise拒绝警告在本地开发时可能一眼就能察觉，但到了CI环节，因为Jest不会把它标记为测试失败，很容易就漏掉了。下面给你几个实用的解决方案，帮你把这些警告变成硬失败，让CI能及时捕获问题：

方法一：全局监听未处理的Promise拒绝，强制抛出错误 #

你可以在Jest的全局配置文件里监听Node的unhandledRejection事件，把所有未处理的Promise拒绝直接转换成抛出错误，这样Jest就会把这类情况判定为测试失败。

1. 创建一个Jest的setup文件，比如jest.setup.js，写入以下代码：

// 把未处理的Promise拒绝转换成抛出错误
process.on('unhandledRejection', (reason) => {
  console.error('Unhandled Promise Rejection:', reason);
  throw reason; // 抛出错误让Jest捕获
});

2. 在你的jest.config.js里配置这个setup文件，让Jest在测试前加载它：

module.exports = {
  // 其他配置...
  setupFilesAfterEnv: ['./jest.setup.js'],
};

这样一来，任何未被处理的Promise拒绝都会直接触发测试失败，CI就能第一时间发现问题。

方法二：在单个测试用例中显式处理Promise拒绝 #

对于特定的异步测试，你要确保Promise的拒绝被正确断言，避免出现未处理的情况。这里有几种常见的写法：

用expect().rejects.toThrow()断言拒绝 #

这是Jest推荐的简洁写法：

test('测试异步函数会抛出预期错误', async () => {
  // 直接断言Promise会拒绝并抛出指定错误
  await expect(yourAsyncFunction()).rejects.toThrow('预期的错误信息');
});

用try/catch手动捕获并断言 #

如果你需要更细致的错误处理，可以用try/catch包裹异步调用：

test('捕获异步函数的拒绝', async () => {
  try {
    await yourAsyncFunction();
    // 如果函数没有拒绝，就主动标记测试失败
    fail('该异步函数本应拒绝，但实际没有');
  } catch (error) {
    // 断言错误的类型或内容
    expect(error).toBeInstanceOf(Error);
    expect(error.message).toBe('预期的错误信息');
  }
});

确保返回Promise（针对非async/await写法） #

如果你不用async/await，记得要返回Promise，让Jest等待它完成：

test('返回Promise让Jest等待处理', () => {
  return yourAsyncFunction().catch(error => {
    expect(error.message).toBe('预期的错误信息');
  });
});

额外提示 #

• 如果你使用的是较新版本的Jest，可以尝试开启--detectOpenHandles参数，它能帮助你发现一些未正确清理的异步操作，但核心解决未处理Promise拒绝的问题还是依赖上面两种方法。
• 尽量在测试中显式处理所有异步操作的结果，不管是resolve还是reject，这不仅能避免警告，还能让你的测试逻辑更健壮。

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