大网数据广告活动
Web 标准与前端开发

unhandledrejection

· 52CE 我爱测

当 Promise 被 reject 且没有 reject 处理器的时候,会触发 **`unhandledrejection`** 事件;这可能发生在 window 下,但也可能发生在 Worker 中。这对于调试和为意外情况提供后备错误处理非常有用。

HTML DOM

当 Promise 被 reject 且没有 reject 处理器的时候,会触发 unhandledrejection 事件;这可能发生在 window 下,但也可能发生在 Worker 中。这对于调试和为意外情况提供后备错误处理非常有用。

<table class="properties"> <tbody> <tr> <th scope="row">是否冒泡</th> <td>No</td> </tr> <tr> <th scope="row">是否可取消</th> <td>Yes</td> </tr> <tr> <th scope="row">接口</th> <td>PromiseRejectionEvent</td> </tr> <tr> <th scope="row">事件处理器属性</th> <td> WindowEventHandlers.onunhandledrejection </td> </tr> </tbody> </table>

事件属性

unhandledrejection 继承自 PromiseRejectionEvent,而 PromiseRejectionEvent 又继承自 Event。因此unhandledrejection 含有 PromiseRejectionEvent 和 Event 的属性和方法。主要包含两个有用的属性:

  • promise
    • : 特定的被 reject 且没有 reject 处理器的 Promise
  • reason
    • : 将会传入异常处理方法中的错误原因(如果存在),查看 Promise.catch 相关以获取更多细节。

使用说明

允许 unhandlejection 事件冒泡将最终导致向控制台输出错误消息。可以通过调用 PromiseRejectionEvent 上的 Event.preventDefault 来阻止这种情况;请参阅下面的阻止默认处理示例。

例子

我们将通过几个例子来展示 unhandledrejection 事件的使用方式。

基本的异常上报

此示例只是将有关未处理的 Promise rejection 信息打印到控制台。

window.addEventListener("unhandledrejection", (event) => {
  console.warn(`UNHANDLED PROMISE REJECTION: ${event.reason}`);
});

你还可以使用 WindowEventHandlers.onunhandledrejection 事件处理程序属性来设置事件侦听器:

window.onunhandledrejection = (event) => {
  console.warn(`UNHANDLED PROMISE REJECTION: ${event.reason}`);
};

阻止默认处理

许多环境 (例如 Node.js ) 默认情况下会向控制台打印未处理的 Promise rejections。你可以通过为 unhandledrejection 事件添加一个处理程序来避免这种情况的发生,该处理程序除了执行你希望执行的任何其他任务之外,还可以调用 Event.preventDefault() 来取消该事件,从而阻止该事件冒泡并由运行时的日志代码处理。这种方法之所以有效,是因为 unhandledrejection 事件是可以取消的。

window.addEventListener("unhandledrejection", function (event) {
  // ...你的代码可以处理未处理的 rejection...

  // 阻止默认处理(例如将错误输出到控制台)

  event.preventDefault();
});

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。