使用Jest测试回调函数时是否必须使用try/catch？

核心结论 #

Jest文档的内容并非误导或过时，而是版本迭代带来的行为优化，同时存在部分特定场景仍需依赖try/catch配合done回调的情况。

为什么你现在不需要try/catch也能看到错误 #

Jest 29.x版本（包括你使用的29.7.0）对回调测试的错误处理逻辑做了优化：当expect断言在回调函数中抛出错误时，Jest会自动捕获这个异常，直接标记测试失败并展示错误信息，不再需要手动通过try/catch捕获错误后调用done(error)。

而文档中提到的「无try/catch会超时」的情况，是针对Jest旧版本（比如24.x及更早）的行为——当时Jest无法自动捕获回调内的断言错误，错误会被执行环境吞掉，导致done永远不会被调用，最终测试超时。

哪些场景仍需要try/catch #

虽然单层级回调测试不再需要try/catch，但以下场景必须保留try/catch才能确保测试正常报错：

• 嵌套异步回调：如果回调内部还有另一层异步操作，内层的expect错误无法被Jest顶层捕获，必须在外层try/catch中捕获错误并传给done。
• 回调自带错误捕获逻辑：如果被测试的回调函数内部有自己的try/catch吞掉了异常，需要手动在catch块中调用done(error)通知Jest测试失败。
• 第三方库回调吞异常：部分第三方库的回调会内部处理错误，不向外抛出，此时必须手动捕获断言错误并触发done。

示例对比 #

无需try/catch的场景（当前Jest版本支持）

test('fetchData returns correct value', (done) => {
  fetchData((data) => {
    expect(data).toBe('peanut butter');
    done();
  });
});

当data为strawberry jam时，expect抛出错误，Jest自动捕获并展示「预期值与实际值不符」的错误，不会超时。

需要try/catch的场景（嵌套异步）

test('nested async operations work correctly', (done) => {
  fetchData((data) => {
    try {
      expect(data).toBe('peanut butter');
      // 内层异步调用
      fetchAnotherData((anotherData) => {
        expect(anotherData).toBe('jelly');
        done();
      });
    } catch (error) {
      done(error); // 手动传递错误给Jest
    }
  });
});

如果去掉外层try/catch，第一个expect抛出的错误会被吞掉，Jest无法感知到失败，最终测试超时。

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