JS异步测试核心是准确模拟异步行为、捕获时机、验证结果,需重点练习三类场景:1. setTimeout配合fake timers;2. Promise的resolve/reject双路径;3. async/await的自然写法;4. fetch等依赖的细粒度mock。

直接上手写测试,别光看理论。JS 异步代码测试的核心不是“会不会写 test”,而是“能不能准确模拟异步行为、捕获执行时机、验证回调/状态/Promise 结果”。重点练三类场景:回调函数、Promise 链、async/await 函数。
一、从最简单的 setTimeout 测试开始
这是理解异步测试逻辑的起点。关键不是测定时器本身,而是测它触发的副作用(比如调用回调、修改状态、更新 DOM)。
- 用 jest.useFakeTimers() 拦截定时器,避免真实等待 —— 调用
jest.runAllTimers()或jest.advanceTimersByTime(1000)主动推进时间 - 确保被测函数接收回调参数,并在测试中传入 mock 回调,最后用
expect(mockCallback).toHaveBeenCalledWith(expectedValue)断言 - 别忘了清理:测试后调用
jest.useRealTimers(),或在afterEach中重置
二、Promise 测试必须覆盖 resolve 和 reject 两种路径
很多初学者只测成功,漏掉错误分支,导致线上异常未被捕获。
- 对返回 Promise 的函数,用 return expect(...).resolves.toEqual(...) 测成功;用 return expect(...).rejects.toThrow(...) 测失败(注意 return,否则 Jest 不知道要等 Promise)
- 手动构造 rejected Promise 测试错误处理:例如
mockImplementation(() => Promise.reject(new Error('网络超时'))) - 避免在测试里写
.then().catch()手动处理 —— 这会让 Jest 失去对 Promise 生命周期的控制,容易误判为“测试通过”
三、async/await 函数测试要和普通函数一样自然
async 函数本质返回 Promise,所以测试方式和 Promise 一致,但写法更简洁。
- 直接 await 被测函数调用,然后断言结果:
const result = await myAsyncFn(); expect(result).toBe(...) - 错误分支用 try/catch + expect:在 try 中 await,catch 中断言 error,比
.rejects更贴近真实业务写法 - 注意顶层 await 在测试文件中可用(Jest 支持 ESM),但不要在 describe/it 外部 await,会破坏测试隔离性
四、绕不开的:模拟异步依赖(fetch、API 调用)
真实请求不能进单元测试。必须用 mock 替换。
- 全局 mock fetch:
global.fetch = jest.fn(),然后用mockResolvedValue或mockRejectedValue控制响应 - 返回不同状态码:模拟 404、500 时,
mockResolvedValue({ ok: false, status: 404 }),再让业务代码自己解析 - 避免 mock 整个模块(如
jest.mock('./api'))除非必要 —— 细粒度 mock fetch 更灵活,也更贴近运行时真实行为


















