测试复杂 promise 链需控制异步、隔离依赖、验证状态流转与错误传播;须 mock fetch 等 i/o,逐层断言中间值,主动触发错误路径,并覆盖 all/race/allsettled 组合逻辑。

测试复杂的 Promise 链条,核心是控制异步行为、隔离外部依赖、验证状态流转和错误传播路径。不能只测“最终结果”,更要覆盖中间环节的返回值、reject 时机、错误冒泡是否准确、以及并行/串行组合逻辑。
用 Jest 或 Vitest 模拟异步操作
真实网络请求(如 fetch)必须 mock,否则测试不可靠、慢且不稳定:
- 用 Jest.mock('node:fs/promises') 或 vi.mock('node:fs') 替换文件读取等 I/O 操作
- 对 fetch 全局方法做 mock:在测试前 vi.mock('whatwg-fetch') 或直接 global.fetch = vi.fn(),再按需返回 resolve 或 reject 的 Response
- 每个 mock 返回一个已知状态的 Promise,比如:fetch.mockResolvedValue(new Response(JSON.stringify({id: 1})))
逐层断言 Promise 链的中间值
Promise 链不是黑盒——每个 .then() 的输入输出都可验证。关键在于拆解链、提取单个步骤做单元测试:
- 把链中每个处理函数单独导出(例如 fetchUser → parseUser → fetchOrders),分别测试它们接收什么、返回什么 Promise
- 对某一步调用后立即 await,检查它是否返回预期结构的 Promise:expect(step(user)).resolves.toEqual({...})
- 避免只测整条链的最终 .then();要测第 2 步是否真的用上了第 1 步的返回值
强制触发错误路径与冒泡行为
Promise 链的错误处理机制容易被忽略。测试时必须主动制造失败,并确认它是否按预期跳过后续 .then()、直达 .catch():
- mock 某个中间 fetch 返回 new Response('', {status: 500}),或直接 fetch.mockRejectedValue(new Error('timeout'))
- 用 expect(...).rejects.toThrow() 断言整个链是否拒绝,再用 expect(fn).not.toHaveBeenCalled() 验证后续步骤未执行
- 特别注意:如果某个 .then() 内部 throw,也会触发 reject;这属于合法错误传播,要覆盖
验证 Promise.all / race / allSettled 组合逻辑
含并行操作的链更易出错。测试重点不是“快”,而是“行为确定性”:
- Promise.all:mock 两个 Promise,一个 resolve、一个 reject,确认整体 reject 且不等待另一个完成
- Promise.race:mock 一个快 resolve、一个慢 reject,验证结果是快的那个,且慢的被忽略(不触发 catch)
- Promise.allSettled:确保无论成功失败,所有结果都进入数组,且 status 字段正确为 'fulfilled' 或 'rejected'
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











