JS异步测试反模式核心是未等对时机或未管住副作用,需用async/await等待Promise、全面mock异步路径、eachTest前后清理状态、配合runAllTimers/waitFor确保断言时机正确。

JS 异步代码测试中,反模式往往不是功能写错了,而是测试本身没“等对时机”或“管住副作用”,导致结果不可靠、时而通过时而失败。规避关键在于:让测试明确感知异步完成、隔离外部依赖、避免竞态与状态污染。
不等待 Promise 完成就断言
常见于直接调用返回 Promise 的函数后立刻 expect,测试在异步逻辑执行前就结束了。
✅ 正确做法:
- 使用 async/await 并 await 被测函数调用(最直观)
- 返回 Promise 给测试框架(如 Jest 支持自动等待返回的 Promise)
- 避免仅靠 setTimeout 或 done 回调——易误判超时或遗漏 reject
示例:
❌ 错误test('should fetch user', () => {<br> fetchUser(123).then(user => expect(user.name).toBe('Alice'));<br>});✅ 正确
test('should fetch user', async () => {<br> const user = await fetchUser(123);<br> expect(user.name).toBe('Alice');<br>});
Mock 未覆盖所有异步路径
只 mock 了成功分支(如 resolve),却忽略 reject、loading 中间态、重复调用、取消请求等边界情况,导致测试覆盖率虚高、线上出错。
使用约定式提交(Conventional Commits)生成标准化的 Git 提交信息。适用于以下场景: (1) 暂存更改时需要提交信息; (2) 审查 diff 时希望获得结构化摘要; (3) 编写 PR 描述或变更日志(changelog)条目; (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff,并生成按类型(type)划分范围的提交信息。
✅ 正确做法:
- 对每个被测异步函数,至少覆盖 resolve / reject / pending 中断 三种行为
- 用 jest.mock 或 mockImplementationOnce 精确控制返回值序列
- 测试取消逻辑时,主动调用 AbortController.abort() 或模拟 race 场景
测试间共享异步状态(如全局计时器、缓存、事件监听)
一个测试里启动了 setInterval、注册了 window.addEventListener('unhandledrejection')、或修改了 localStorage,未清理就进入下一个测试,造成干扰或内存泄漏。
✅ 正确做法:
- 在 beforeEach 初始化干净环境,在 afterEach 清理副作用(clearTimeout、removeEventListener、localStorage.clear)
- 对定时器统一使用 jest.useFakeTimers(),并显式 jest.runAllTimers() 或 advanceBy
- 避免在 test 块外声明变量并跨测试复用;优先用局部变量 + 工厂函数构造测试数据
用 toBeCalledTimes 断言异步回调,却不等它发生
比如 mock 一个传给 setTimeout 的回调,然后立即 expect(mockFn).toBeCalledTimes(1),但此时回调尚未执行。
✅ 正确做法:
- 配合 jest.runAllTimers() 或 jest.advanceTimersByTime(ms) 推进时间
- 用 waitFor(Jest 也提供 waitFor 辅助函数)等待断言成立,而非依赖固定延时
- 对事件监听类逻辑,用 act + waitFor(React Testing Library 场景)确保渲染同步

















