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();
});
规范
浏览器兼容性
参见
- Promise 拒绝事件
- Window/rejectionhandled_event 事件
- Promise
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
