JavaScript 中 Promise 怎么在单元测试中异步断言 Promise 的成功与失败结果-js教程-PHP中文网

关键在于用 async/await 配合 expect(...).resolves 或 expect(...).rejects 断言，确保等待 promise 完成并校验其 resolved 值或 rejected 原因，避免遗漏 await 或混用回调风格。

javascript 中 promise 怎么在单元测试中异步断言 promise 的成功与失败结果

在单元测试中验证 Promise 的成功与失败结果，关键在于正确等待 Promise 完成，并捕获其 resolved 值或 rejected 原因。不同测试框架（如 Jest、Vitest、Jasmine）略有差异，但核心逻辑一致：不能直接对 Promise 实例做断言，而要对其最终状态和结果进行断言。

使用 async/await 断言 Promise 成功结果

最直观的方式是将测试函数声明为 async，用 await 获取 resolved 值，再进行普通断言：

// Jest / Vitest 示例
test('fetchUser 返回正确的用户对象', async () => {
  const user = await fetchUser(123);
  expect(user.id).toBe(123);
  expect(user.name).toBe('Alice');
});

注意：若 Promise 被 reject，测试会自动失败并抛出错误——这本身已是“失败被检测到”的表现，但不便于自定义错误断言。

显式断言 Promise 被 reject（捕获错误原因）

要验证 Promise 确实失败，且失败原因符合预期（如特定错误消息、错误类型），需用 expect(...).rejects（Jest/Vitest）或 await expect(...).rejects.toThrow(...) 等语法：

deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

Jest / Vitest： await expect(promise).rejects.toEqual(expectedError) 或 .rejects.toThrow('Network error')
示例：

test('fetchUser 拒绝时返回 NetworkError', async () => {
  await expect(fetchUser(-1)).rejects.toThrow('Network error');
  // 或更精确地匹配错误实例
  await expect(fetchUser(-1)).rejects.toEqual(new Error('Network error'));
});

避免常见陷阱：不要忘记 await，也不要混用 done() 和 async

以下写法是错误的：

expect(fetchUser(123)).resolves.toBeDefined() —— ❌ 缺少 await，断言的是 Promise 对象本身，不是它的结果
test('...', (done) => { fetchUser(123).then(() => { expect(...); done(); }); }); —— ⚠️ 过时冗长，易漏 done() 或未处理 reject
async test(...) { expect(promise).rejects... } —— ❌ 忘记 await 前缀，断言不会等待，导致误通过

正确写法始终是：await expect(...).resolves.xxx 或 await expect(...).rejects.xxx。

测试 Promise 链或含副作用的异步逻辑（如 mock API）

实际中常需控制异步行为，例如模拟 API 失败：

用 jest.mock 或 vi.mock 替换依赖的 fetch 函数
返回一个 resolve/reject 的 Promise，再执行待测函数
确保所有异步路径都被覆盖（success / failure / timeout）

// Vitest 中 mock fetch 失败
vi.mock('@/api/user', () => ({
  fetchUser: vi.fn().mockRejectedValue(new Error('Timeout'))
}));

test('handleUserLoad 显示错误提示', async () => {
  const result = await handleUserLoad(456);
  expect(result.error).toBe('Timeout');
});

只要 Promise 返回值明确、测试函数标记为 async、断言前加 await，就能可靠验证成功与失败路径。不需要手动写 try/catch，现代测试框架的 .resolves 和 .rejects 已封装好时序与错误捕获逻辑。