Skip to content

测试超时:异步测试未完成

快速摘要

你的测试超时了 —— 异步操作或 promise 未在超时时间内 resolve 或 reject。

为什么发生

  • 测试中的异步操作永不 resolve,因为底层 promise 未被结算

  • 测试等待的事件或条件因逻辑错误而永不发生

  • 测试超时设置对于网络请求等合法的慢操作来说太低

最小示例

✗ 错误代码
test('fetches user data', async () => {
  const promise = fetchUser(1); // missing await
  expect(promise.name).toBe('John'); // promise is not resolved — timeout
});
✓ 修复代码
test('fetches user data', async () => {
  const user = await fetchUser(1);
  expect(user.name).toBe('John');
});

添加缺失的 await 关键字确保 promise 在断言运行前已 resolve,防止超时。

如何诊断

  • 检查测试中是否有未 await 的 promise 或缺少 await 关键字

  • 查看测试中依赖可能不可用的外部资源的操作

  • 临时增大超时时间以查看测试最终是否通过

如何修复

  • 为测试中的所有异步操作添加缺失的 await 关键字

  • Mock 外部依赖,使测试不等待真实网络或 I/O

  • 用 test.timeout() 或每测试超时选项增大测试超时

如何预防

  • 在异步测试中始终 await 所有 promise,并使用 lint 规则捕获缺失的 await

  • 在单元测试中 mock 外部依赖以避免真实 I/O 和网络延迟

相关资源

相关术语

相关课程

← 返回语言