Skip to content

测试中未处理的 promise 拒绝

快速摘要

你的测试有未处理的 promise 拒绝 —— promise 被 reject 但没有 .catch() 或 try/catch 处理它。

为什么发生

  • 异步操作 reject 但测试未 await 它或捕获拒绝

  • 即发即忘的 promise 在测试中启动并稍后 reject,在测试作用域之外

  • 事件处理器或回调创建的 promise reject 但无 catch 处理器

最小示例

✗ 错误代码
test('sends notification', () => {
  sendNotification('Hello'); // returns a promise, not awaited
  // if sendNotification rejects, unhandled rejection!
  expect(log).toContain('sent');
});
✓ 修复代码
test('sends notification', async () => {
  await sendNotification('Hello'); // rejection is caught by test
  expect(log).toContain('sent');
});

Await promise 确保如果它 reject,测试以清晰错误失败而非未处理拒绝警告。

如何诊断

  • 检查测试中未 await 的 promise,可能在测试完成后 reject

  • 查看被测代码中缺少 .catch() 处理器的 promise 链

  • 在测试期间使用 process.on('unhandledRejection') 记录拒绝来源

如何修复

  • 在测试中 await 所有 promise,使拒绝被测试框架捕获

  • 为即发即忘的 promise 添加 .catch() 处理器或使用 Promise.all 来 await

  • 修复被测代码以用 try/catch 或 .catch() 正确处理 promise 拒绝

如何预防

  • 在测试中始终 await promise,并启用标记浮动 promise 的 lint 规则

  • 在测试 setup 中添加全局未处理拒绝处理器以捕获游离拒绝

相关资源

相关术语

相关课程

← 返回语言