JesttoThrowError用法全解析
golang学习网今天将给大家带来《Jest rejects.toThrowError用法详解》,感兴趣的朋友请继续看下去吧!以下内容将会涉及到等等知识点,如果你是正在学习文章或者已经是大佬级别了,都非常欢迎也希望大家都能给我建议评论哈~希望能帮助到大家!

Jest中异步函数异常测试的核心原理
在JavaScript的测试框架Jest中,测试函数是否抛出异常是一个常见的需求。对于同步函数,我们通常使用.toThrow()匹配器,它期望接收一个会抛出错误的函数作为参数,例如expect(() => syncFun()).toThrowError(errorObj)。然而,当涉及到异步函数时,情况变得更加复杂,因为异步操作返回的是Promise。Jest为此提供了.rejects匹配器,专门用于断言一个Promise是否被拒绝(rejected),并且在拒绝时携带了预期的错误。
理解.rejects的关键在于它操作的是一个Promise对象,而不是一个返回Promise的函数。当一个异步函数在执行过程中抛出错误时,它会导致其返回的Promise被拒绝。因此,我们的测试目标是检查这个被拒绝的Promise是否携带了特定的错误信息。
正确姿势:直接操作Promise
在Jest中测试异步函数抛出异常的正确且推荐方式是直接将异步函数执行后返回的Promise传递给expect()。
示例代码:
// 假设有一个异步函数,它会因某些条件拒绝Promise
async function fetchDataWithError() {
return new Promise((resolve, reject) => {
setTimeout(() => {
// 模拟异步操作失败,拒绝Promise并抛出错误
reject(new Error('数据加载失败:网络连接中断!'));
}, 100);
});
}
describe('测试异步函数抛出异常的正确方式', () => {
test('fetchDataWithError 应该拒绝并抛出指定错误', async () => {
// 正确的测试方式:直接将 asyncFun() 执行后返回的 Promise 传递给 expect
await expect(fetchDataWithError()).rejects.toThrowError('数据加载失败:网络连接中断!');
});
test('fetchDataWithError 应该拒绝并抛出 Error 类的实例', async () => {
// 也可以检查错误类型
await expect(fetchDataWithError()).rejects.toThrow(Error);
});
test('fetchDataWithError 应该拒绝并抛出具有特定属性的错误对象', async () => {
// 如果错误对象有特定属性,可以匹配正则表达式或部分文本
await expect(fetchDataWithError()).rejects.toThrowError(/网络连接中断/);
});
});解析:asyncFun()(如fetchDataWithError())在被调用时会立即开始执行,并返回一个Promise。expect()接收到这个Promise后,await会等待这个Promise的状态。如果Promise被拒绝,.rejects匹配器会捕获这个拒绝,并允许我们链式调用.toThrowError()来验证拒绝的原因是否是预期的错误。这种方式清晰地表达了“我们期望这个Promise会被拒绝并携带一个特定的错误”。
误区解析:将函数传递给expect
另一种常见的尝试是像同步函数那样,将一个包装了异步函数调用的匿名函数传递给expect(),例如:
// 错误的示例(不推荐)
// await expect(async () => {
// await asyncFun();
// }).rejects.toThrowError(errorObj);为什么这种方式是错误的或不推荐的?
- 违背设计意图: Jest的.rejects匹配器是专门为Promise设计的。它的核心功能是检查一个Promise的拒绝状态。当它接收到一个函数时,它并非被设计为去执行这个函数并检查其内部的Promise。虽然在某些Jest版本或特定场景下,这种写法可能“碰巧”工作,但这并非其官方文档所推荐或保证的行为。
- 不必要的抽象: 这种写法引入了一个额外的匿名异步函数,其唯一目的是包装对asyncFun()的调用。这增加了代码的复杂性,却没有带来任何语义上的好处。
- 潜在的不稳定性: 由于这种用法不是.rejects的预期行为,未来的Jest版本更新可能会改变其内部实现,导致这种测试突然失效。依赖未文档化的行为总是存在风险。
- 混淆概念: 这种写法容易让人联想到同步的.toThrow(),它确实需要一个抛出错误的函数。但这会将异步和同步的错误处理机制混淆,不利于对Promise链式操作的理解。
本质上,当您写await expect(async () => { await asyncFun() })时,您传递给expect的是一个函数,而不是asyncFun()执行后返回的Promise。rejects应该直接作用于Promise对象,而不是一个返回Promise的函数。
注意事项与最佳实践
- 理解匹配器输入: 始终明确你传递给expect()的是什么类型的数据。toThrow()期望一个会同步抛出错误的函数;rejects期望一个Promise。
- Promise的返回: 确保你的异步函数确实返回了一个Promise(或者是一个async函数,它隐式返回一个Promise)。如果异步函数没有返回Promise,.rejects将无法正常工作。
- 避免副作用: 确保你的测试是独立的,并且异步函数在测试期间不会产生意外的副作用。
- 查阅官方文档: 遇到不确定的用法时,Jest的官方文档是最佳的参考来源。它详细说明了每个匹配器的预期输入和行为。
总结
在Jest中测试异步函数抛出异常时,请务必遵循官方推荐的最佳实践:直接将异步函数执行后返回的Promise传递给expect(),然后链式调用.rejects.toThrowError()。这种方式不仅语义清晰、代码简洁,而且符合Jest的设计哲学,能够确保你的测试在未来具有更好的稳定性和可维护性。避免使用将包装函数传递给expect的写法,因为它依赖于未文档化的行为,可能导致不可预测的结果。理解Promise的工作机制是编写健壮异步测试的关键。
以上就是《JesttoThrowError用法全解析》的详细内容,更多关于的资料请关注golang学习网公众号!
PHP代码防篡改方法:数字签名与加密技术解析
- 上一篇
- PHP代码防篡改方法:数字签名与加密技术解析
- 下一篇
- Linux安装缺少固件解决方法大全
-
- 文章 · 前端 | 1天前 | 流式处理 · javascript · 浏览器API · JavaScript UTF-8 ReadableStream Web Streams WritableStream TextEncoderStream
- Web Streams TextEncoderStream 怎样把字符串转换成字节流
- 358浏览 收藏
-
- 文章 · 前端 | 1天前 | javascript · 浏览器API · Web Locks API navigator.locks.request 同源标签页 共享任务 浏览器并发
- Web Locks API 怎样让同源标签页串行执行共享任务
- 445浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · css · CSS 组件样式 @scope scope root scope limit 选择器作用域
- CSS @scope 怎样限制选择器只作用于局部组件
- 210浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · JavaScript translate HTMLElement 产品名称
- JavaScript HTMLElement.translate 怎样标记无需翻译的产品名称
- 483浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · javascript · JavaScript IntersectionObserver rootMargin threshold intersectionRatio
- JavaScript IntersectionObserver 怎样设置多级阈值
- 289浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · JavaScript postMessage Message BroadcastChannel close 同源页面通信
- JavaScript BroadcastChannel 怎样在同源页面间传递消息
- 403浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · javascript · JavaScript iframe document importNode createHTMLDocument DOMImplementation
- JavaScript createHTMLDocument 怎样在独立文档中组装 HTML
- 329浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · websocket · JavaScript websocket CloseEvent 关闭事件
- JavaScript WebSocket 怎样处理 close 事件的 code 和 reason
- 239浏览 收藏
-
- 文章 · 前端 | 2天前 |
- JavaScript structuredClone 复制 Error 对象怎样保留错误信息
- 261浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · JavaScript Fetch AbortController AbortSignal abort reason
- JavaScript AbortController.abort(reason) 怎样把取消原因传给调用方
- 423浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · 错误处理 · JavaScript Fetch response HTTP 404
- JavaScript fetch 怎样区分网络失败和 HTTP 404
- 239浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1173次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1157次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1338次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1281次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1139次使用
-
- JavaScript函数定义及示例详解
- 2025-05-11 502浏览
-
- 智能体安全引领产业升级——国内AI安全产品市场深度分析
- 2026-08-21 501浏览
-
- CSS变量简化按钮悬停效果技巧
- 2026-05-31 501浏览
-
- JavaScript符号类型详解与应用
- 2026-05-31 501浏览
-
- HTML剪贴板复制粘贴怎么用
- 2026-05-26 501浏览

