如何在 Jest 测试中正确处理循环内的异步 expect 断言

在 jest 单元测试中，直接对 `object.keys().map()` 等高阶函数使用 `async/await` 会导致断言失效——因为 `map` 不等待 promise 完成，所有 `expect(...).rejects.tothrow()` 调用实际未被 jest 捕获。需改用 `promise.all` 或自定义异步映射工具确保断言同步执行。

Jest 的 expect().rejects.toThrow() 必须在测试上下文中同步触发并等待其完成，否则 Jest 无法捕获异常、也无法判断断言是否通过。而原代码中：

Object.keys(Status).map(async (key) => {
  if (Status[key] !== Status.PENDING_REVISION) {
    mockAdsRepository.findOne = jest.fn(() =>
      Promise.resolve({ ...adsDto, status: Status[key] }),
    );
    await expect(service.approve(1, 1)).rejects.toThrow(BadRequestException);
  }
});

Array.prototype.map() 会立即返回一个包含多个 pending Promise 的数组，但 Jest 完全忽略该数组——既不 await 它，也不检查其中任何 Promise 的结果。这导致：

• 所有 expect(...).rejects.toThrow() 实际未被执行（或在测试结束之后才 resolve）；
• 测试“静默通过”，即使某些状态本应成功（如 PENDING_REVISION）却未被验证；
• 无法定位具体哪个枚举值触发了意外行为。

✅ 正确做法：显式等待所有异步断言完成。推荐两种可靠方案：

方案一：使用 Promise.all() + for...of（简洁推荐）

it('should block approval of ads if status is not in pending revision', async () => {
  const invalidStatuses = Object.values(Status).filter(
    status => status !== Status.PENDING_REVISION,
  );

  // 逐个测试，全部 await
  await Promise.all(
    invalidStatuses.map(async (status) => {
      mockAdsRepository.findOne = jest.fn(() =>
        Promise.resolve({ ...adsDto, status }),
      );
      await expect(service.approve(1, 1)).rejects.toThrow(BadRequestException);
    }),
  );
});

✅ 优势：无需额外工具函数；语义清晰；Promise.all 确保所有断言并发执行且全部完成后再退出测试。

方案二：封装可复用的 mapAsync 工具（适合复杂场景）

如答案中所提，可创建类型安全的异步映射函数：

360智图

AI驱动的图片版权查询平台

下载

// utils/test-utils.ts
export async function mapAsync(
  elements: readonly T[],
  mapAction: (item: T) => Promise,
): Promise {
  const results: R[] = [];
  for (const element of elements) {
    results.push(await mapAction(element));
  }
  return results;
}

在测试中使用：

import { mapAsync } from './utils/test-utils';

it('should block approval of ads if status is not in pending revision', async () => {
  const invalidStatuses = Object.values(Status).filter(
    status => status !== Status.PENDING_REVISION,
  );

  await mapAsync(invalidStatuses, async (status) => {
    mockAdsRepository.findOne = jest.fn(() =>
      Promise.resolve({ ...adsDto, status }),
    );
    await expect(service.approve(1, 1)).rejects.toThrow(BadRequestException);
  });
});

⚠️ 注意事项：

• ❌ 避免 forEach(async () => {}) —— 同样存在未等待问题；
• ❌ 不要省略 await 在 expect(...).rejects.toThrow() 前，否则 Jest 会报 Error: expect(received).rejects.toThrow() cannot be called on a non-promise；
• ✅ 使用 Object.values(Status) 而非 Object.keys(Status)，避免将数字键（如 0, 1）误作枚举值（TypeScript 枚举默认双向映射，keys() 会返回字符串键和数字索引）；
• ✅ 若需测试「唯一允许通过的状态」，建议单独补一个正向用例：

  it('should allow approval only when status is PENDING_REVISION', async () => {
    mockAdsRepository.findOne = jest.fn(() =>
      Promise.resolve({ ...adsDto, status: Status.PENDING_REVISION }),
    );
    await expect(service.approve(1, 1)).resolves.not.toThrow(); // 或具体返回值断言
  });

总结：Jest 测试中所有异步断言必须被显式 await 并纳入测试生命周期。循环内断言不是语法限制，而是执行时序问题——用 Promise.all 或顺序 for...of + await 即可彻底解决，保障测试健壮性与可维护性。