async函数中未捕获的Promise拒绝会触发unhandledrejection全局事件,浏览器用window.addEventListener监听,Node.js用process.on监听,可获取reason和promise,但仅捕获未处理的异步错误且不适用于Promise.allSettled。

在 JavaScript 中,async 函数内未捕获的 Promise 拒绝(即抛出但未被 catch 或 try/catch 处理的异常),会触发全局事件 unhandledrejection。这是监听和处理“漏网”异步错误的核心机制。
监听 unhandledrejection 事件
该事件在浏览器和 Node.js(v15+)中均可用,用于捕获未被处理的 Promise rejection:
- 浏览器中通过
window.addEventListener('unhandledrejection', handler) - Node.js 中通过
process.on('unhandledRejection', handler) - 事件对象包含
reason(拒绝值,通常是 Error 实例)和promise(被拒绝的 Promise 对象)
基本监听写法(浏览器端)
推荐在应用初始化时尽早注册监听,避免错过早期异常:
window.addEventListener('unhandledrejection', (event) => {
console.error('Unhandled async rejection:', event.reason);
// 可选:阻止默认行为(如控制台警告)
event.preventDefault();
// 可选:上报错误、记录日志、提示用户等
});
Node.js 环境中的处理方式
Node.js 不仅支持 unhandledRejection,还建议同时监听 rejectionHandled(当 Promise 后续被 catch 时触发),用于检测“延迟捕获”行为:
立即学习“Java免费学习笔记(深入)”;
process.on('unhandledRejection', (reason, promise) => { ... })process.on('rejectionHandled', (promise) => { ... })- 注意:Node.js v15+ 默认将未处理的 rejection 视为致命错误并退出进程,因此必须显式监听以避免崩溃
注意事项与常见误区
这个机制不是万能兜底,需注意边界情况:
- 仅捕获未被
await、.catch()或try/catch处理的 Promise rejection,不捕获同步错误或已处理的异常 - 无法获取原始调用栈的完整上下文(
reason.stack可能有限),建议在async内部优先使用try/catch - 多个
unhandledrejection监听器会依次执行;若某监听器调用了event.preventDefault(),不会阻止其他监听器运行,但会抑制浏览器默认警告 - 不适用于已被
Promise.allSettled包裹的 Promise —— 它们永远不会触发此事件










