done 本身无超时参数,超时由测试框架对整个用例设置;Jest 通过 test/it 第三个参数(如 5000)配置,Jasmine 在 it 中传入超时值;应避免混用 async/await 与 done,优先使用 async/await 写法。

在 JavaScript 异步测试中(尤其是使用 Jest 或 Jasmine 时),done 是一个回调函数,用于显式告诉测试框架“这个异步操作已结束”。它本身**没有超时参数**,但测试框架会为整个测试用例设置默认超时时间——超时控制是通过测试函数的配置实现的,而不是传给 done 的。
为什么不能给 done 传超时参数?
done 只是一个通知完成的函数,签名通常是 done() 或 done(error)。它不接收毫秒数或配置对象。所谓“done 超时”,其实是测试运行器对调用 done() 的等待时限。如果测试体执行完毕但 done() 未被调用,框架就会报超时错误。
如何设置和调整超时时间?
不同测试框架设置方式略有不同,以下是常见做法:
-
Jest:在
test或it函数末尾传入超时毫秒数it('should fetch user', (done) => { /* async code */ }, 5000);
这表示该测试最多等待 5 秒,超时后即使done()没被调用也会失败。 -
Jasmine(如 Karma + Jasmine):通过
jasmine.DEFAULT_TIMEOUT_INTERVAL全局设置,或在it中用setTimeout配合done.fail()手动处理(不推荐);更标准的是在it第三个参数传超时:it('should load data', function(done) { /* ... */ }, 10000); - 注意:超时值必须是数字,不能是字符串或对象;过短易误报(如网络延迟),过长拖慢整体测试速度。
常见错误与建议
容易混淆的点和实用技巧:
立即学习“Java免费学习笔记(深入)”;
- 忘记调用
done()→ 测试挂起直至超时 → 务必在所有分支(包括catch和error回调)中调用done()或done(err)。 - 多次调用
done()→ Jest 会报错 “Done callback called multiple times” → 确保只调用一次,可用标志位防护(但通常靠逻辑避免)。 - 混用
async/await和done→ 不要这么做!Jest 支持async it,应优先用async/await替代done,更简洁且自动处理异常和超时。 - 调试时临时加长超时 → 可以,但上线前应回归合理值(如 2000–5000ms),避免掩盖真实性能问题。
替代方案:优先用 async/await
现代 Jest 推荐写法,无需 done,超时仍由测试函数参数控制:
it('should resolve user', async () => {
const user = await fetchUser();
expect(user.name).toBe('Alice');
}, 3000);这样异常会自动触发失败,逻辑更清晰,也更容易调试。


















