如何正确处理 unhandledrejection 事件并确保脚本持续运行

胖磊大大_5817

胖磊大大_5817

2026-01-25

1049人浏览

原创

如何正确处理 unhandledrejection 事件并确保脚本持续运行

`unhandledrejection` 是浏览器中全局分发的 dom 事件,用于捕获未被 catch 的 promise 拒绝;它**不会中断脚本执行**,仅作为调试与监控机制存在,不影响页面交互或后续代码运行。

unhandledrejection 事件常被误解为“作用域级错误”或“脚本终止信号”,但事实并非如此。这里的“global scope of a script”并非指 JavaScript 的词法作用域(如函数或块级作用域),而是指事件分发的目标对象——即全局执行环境的代表对象:在浏览器主线程中是 window,在 Web Worker 中是 self。该事件本质上是一个标准 DOM 事件,遵循事件冒泡规则(尽管它不冒泡到父元素,只在全局对象上触发),因此可通过 window.addEventListener('unhandledrejection', ...) 或简写 addEventListener('unhandledrejection', ...) 进行监听。

关键点在于:它不阻塞执行流,也不导致脚本崩溃。例如以下代码会正常输出三行日志,并继续执行后续语句:

addEventListener('unhandledrejection', (event) => {
  console.log('unhandledrejection');
  console.log('Promise:', event.promise);
  console.log('Reason:', event.reason);
  // ⚠️ 注意:调用 event.preventDefault() 可阻止默认行为(如控制台警告),
  // 但不会改变 Promise 已被拒绝的事实,也不会恢复执行。
});

Promise.reject('sss');
console.log('✅ 这行仍会执行'); // ✅ 正常输出

输出结果为:

Miller CSV TSV JSON 数据处理器
Miller CSV TSV JSON 数据处理器

Miller (mlr) 是一个命令行工具,用于查询、整形和重新格式化名称索引数据,如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。

下载
unhandledrejection
Promise: Promise {<rejected>: "sss"}
Reason: sss
✅ 这行仍会执行</rejected>

这清晰表明:Promise 拒绝本身是异步操作,unhandledrejection 仅是事后通知机制;JavaScript 引擎继续调度任务、响应用户交互、执行定时器等——整个应用保持完全可用。

⚠️ 注意事项:

  • 该事件不可用于“挽救”已拒绝的 Promise(如自动 .catch())。它纯属观测用途,适合日志上报、错误监控或开发提醒;
  • 若需防止 unhandledrejection 触发,应在 Promise 链末尾显式添加 .catch() 或 await 后包裹 try/catch;
  • 在 Node.js 环境中行为不同:v15+ 默认将未处理拒绝视为致命错误并退出进程(可通过 process.on('unhandledRejection', ...) 捕获并 process.exitCode = 0 避免退出);
  • 浏览器中即使不监听该事件,脚本也绝不会因此停止运行——最多仅在开发者工具控制台显示黄色警告。

总结:unhandledrejection 是一个诊断性、非侵入式的全局事件,设计初衷是帮助开发者发现遗漏的错误处理逻辑,而非控制程序生命周期。合理使用它可提升健壮性,但切勿将其误认为执行屏障或异常拦截层。

相关专题

更多
线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

2023.08.10

3398

6

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

2023.06.20

3696

8

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.28

1175

5

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1518

5

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

2023.08.17

9143

11

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

820

4

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

2164

5

Js中concat和push的区别
Js中concat和push的区别

Js中concat和push的区别:1、concat用于将两个或多个数组合并成一个新数组,并返回这个新数组,而push用于向数组的末尾添加一个或多个元素,并返回修改后的数组的新长度;2、concat不会修改原始数组,是创建新的数组,而push会修改原数组,将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.14

1389

5

js截取字符串的方法介绍
js截取字符串的方法介绍

JavaScript字符串截取方法,包括substring、slice、substr、charAt和split方法。这些方法可以根据具体需求,灵活地截取字符串的不同部分。在实际开发中,根据具体情况选择合适的方法进行字符串截取,能够提高代码的效率和可读性 。

2023.09.21

3629

3

热门下载

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

精品课程

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

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 11.9万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.5万人学习