关键在于用 async/await 配合 expect(...).resolves 或 expect(...).rejects 断言，确保等待 Promise 完成并校验其 resolved 值或 rejected 原因，避免遗漏 await 或混用回调风格。
在单元测试中验证 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(...) 等语法：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
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 已封装好时序与错误捕获逻辑。
