讲师中心 微信公众号
AI工具推荐 视频效率加速

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

秋强酱_8743

秋强酱_8743

发布时间:2026-01-29 14:52:01

|

641人浏览过

|

来源于php中文网

原创

如何在 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 工具(适合复杂场景)

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

Galileo TypeScript sdk
Galileo TypeScript sdk

完整的Galileo AI平台 TypeScript/JS SDK 参考,用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。

下载
// utils/test-utils.ts
export async function mapAsync<T, R>(
  elements: readonly T[],
  mapAction: (item: T) => Promise<R>,
): Promise<R[]> {
  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 即可彻底解决,保障测试健壮性与可维护性。

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

相关专题

更多
TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

292

2026.02.13

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

520

2026.02.25

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

371

2026.03.13

TypeScript 全栈开发进阶指南
TypeScript 全栈开发进阶指南

面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

286

2026.06.03

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

638

2026.06.16

php中foreach用法
php中foreach用法

本专题整合了php中foreach用法的相关介绍,阅读专题下面的文章了解更多详细教程。

778

2025.12.04

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

989

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3020

2023.10.25

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.7万人学习

TypeScript——十天技能课堂
TypeScript——十天技能课堂

共21课时 | 1.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn