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); - 注意：超时值必须是数字，不能是字符串或对象；过短易误报（如网络延迟），过长拖慢整体测试速度。
常见错误与建议
容易混淆的点和实用技巧：
- 忘记调用
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);
这样异常会自动触发失败，逻辑更清晰，也更容易调试。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
