javascript单元测试mock promise的核心是替换依赖的异步方法使其返回可控promise;常用方式有直接赋值模拟、jest.mock()自动mock模块、手动构造promise注入;断言需用.resolves/.rejects匹配器。

在 JavaScript 单元测试中 Mock Promise 返回值,核心是**替换被测函数依赖的异步方法,使其返回可控的 Promise(已 resolve 或 reject)**,而不是真实调用。常用方式有三种:直接赋值模拟、使用 jest.mock()、或用 jest.fn() 手动构造。关键不是“怎么写 Promise”,而是“怎么让被测代码拿到你控制的 Promise”。
直接替换模块导出的方法(适合 ESM / CommonJS 简单场景)
如果被测代码从某个模块 import 了一个返回 Promise 的函数(比如 api.fetchUser()),可在测试文件顶部直接重写它:
- ESM 注意:需用
jest.unstable_mockModule(Jest 28+)或改用动态导入 + mock 实现;更稳的做法是配合jest.mock() - CommonJS 可直接赋值:
require('xxx').fetchUser = jest.fn(() => Promise.resolve({ id: 1, name: 'Alice' })) - 确保在
import被测模块之前完成 mock,否则模块已缓存原始实现
用 jest.mock() 自动 Mock 整个模块(推荐,最常用)
这是最清晰、可维护性最好的方式,尤其适合第三方 API 封装模块:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 在测试文件顶部调用:
jest.mock('./api'); // 自动 mock 同目录下 api.js - 然后设置默认导出或具名导出的行为:
const { fetchUser } = require('./api'); fetchUser.mockResolvedValue({ id: 1 }); - 想模拟失败?用
mockRejectedValue(new Error('Network error')) - 注意:mock 必须在
import或require被测模块之前执行
手动构造 Promise 并注入(适合依赖通过参数传入的函数)
当被测函数接收一个异步操作函数作为参数时(如高阶函数、策略模式),无需 mock 模块,直接传入你构造的 Promise:
- 例如函数定义为
async function loadData(fetcher) { return fetcher(); } - 测试时:
await expect(loadData(() => Promise.resolve('ok'))).resolves.toBe('ok'); - 也可用
jest.fn()包一层:const mockFetcher = jest.fn().mockResolvedValue('data');,便于后续断言是否被调用
断言 Promise 结果要选对匹配器
别用 expect(...).toBe(...) 直接比 Promise 对象 —— 它永远不相等。必须用 Jest 提供的异步匹配器:
-
.resolves.toBe(value):等待 Promise 成功,再比结果值 -
.rejects.toThrow('error'):等待 Promise 失败,并检查错误信息 - 搭配
async/await写法更直观:await expect(promise).resolves.toEqual({...}) - 避免忘记
await,否则断言会跑在 Promise 状态改变前,导致误报
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










