测试中未处理的 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 中添加全局未处理拒绝处理器以捕获游离拒绝