JS 中异步代码测试排错指南与经典案例复盘

夜磊酱_6754

夜磊酱_6754

2026-10-20

696人浏览

原创

js异步测试关键在于控制执行时机、捕获异常和断言中间状态。需处理未捕获promise错误、竞态条件、超时取消逻辑、分阶段状态验证,并正确使用await waitfor配合显式timeout。

js 中异步代码测试排错指南与经典案例复盘

JS 异步代码测试排错,关键不在“等它跑完”,而在于“控制它怎么跑、何时跑、跑崩了有没有兜住”。很多测试失败不是逻辑错,是时机没控好、状态没断言全、错误没捕获到。

一、Promise 未捕获异常是最隐蔽的“静默失败”

异步错误若没被 .catch() 或 try/catch 捕获,会变成 unhandledRejection,Jest 默认不报错(但会警告),导致测试看似通过,实际业务逻辑已中断。

  • 在 Jest 中启用严格模式:jest.unstable_mockModule 或配置 unhandledRejection: 'error',让未捕获 Promise reject 直接使测试失败
  • 每个返回 Promise 的函数调用后,显式加 .catch(expect.fail) 或 await expect(...).rejects.toThrow(),堵住漏网之鱼
  • 避免在测试中写 someAsyncFn().then(...) 却不接 catch —— 这等于把错误扔进黑洞

二、竞态条件(Race Condition)测试必须“人为制造先后”

比如搜索建议组件:用户快速输入 “a” → “ab” → “abc”,三个请求并发发出,但“abc”的响应可能先到,“a”的后到。若没做防抖或取消,旧结果会覆盖新结果。

chartjs-reporter
chartjs-reporter

此技能用于在用户需要将结构化数据(查询结果、CSV 摘要、JSON 记录或 Python 字典/列表)转换为独立的 HTML 页面时使用。

下载
  • 用 mock 实现“慢请求先发、快请求后发”:第一个 fetch 返回 new Promise(r => setTimeout(() => r({data: 'a'}), 300)),第二个返回 Promise.resolve({data: 'abc'})
  • 断言最终 state 或 DOM 文本只包含 “abc”,且“a”的回调函数 一次都没执行(检查 mockFn.mock.calls.length === 0)
  • 对 React 组件,配合 act(async () => {...}) + waitFor 确保渲染完成后再断言,避免“快照拍在中间态”

三、超时与取消逻辑不能靠“等真实网络”,得 mock 控制

真实 fetch 超时不可控,测试中必须用可控延迟模拟边界行为。

  • 测试超时分支:给 axios/fetch 封装层传入 timeout: 10,mock 的 Promise 在 15ms 后 resolve —— 应触发超时错误
  • 测试 AbortController 取消:创建 controller,在发起请求后立即 controller.abort(),验证请求函数是否提前退出、是否没调用 setState 或 resolve
  • 检查清理动作:如定时器是否 clearTimeout、事件监听器是否 removeEventListener、loading 状态是否重置为 false

四、生命周期状态断言要分阶段,不能只看“最终结果”

一个 loading → data → error 的异步流程,中间状态变化本身就是契约。只测最终值,等于放弃对交互体验的保障。

  • 初始断言:expect(screen.getByRole('button')).not.toBeDisabled()、expect(state.loading).toBe(false)
  • 发起后立即断言:await waitFor(() => expect(state.loading).toBe(true))(注意:这是同步更新,应瞬间生效)
  • 成功后断言:await waitFor(() => expect(state.data).toBeDefined()),同时确认 loading === false 且 error === null
  • 失败后同理:确保 error 有值、data 为空、loading 已关闭

五、async/await 测试陷阱:别忘了 await waitFor 和 timeout 设置

Jest 默认 5 秒超时,但边界测试常需更短时间暴露问题;用 done 回调则堆栈难读、易遗漏。

  • 所有异步断言优先用 await waitFor(() => expect(...).toBe(...)),语义清晰、失败时定位准
  • 为每个 waitFor 显式设 { timeout: 100 },防止因 mock 延迟过长导致误判为“卡死”
  • 禁用 done:它要求手动调用,一旦忘记或写错位置,测试就挂起(Jest 会超时报错,但看不出哪一行漏了)

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

5026

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1229

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

4944

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

960

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1896

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3525

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

4593

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

3020

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

968

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.2万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.7万人学习