JS异步函数异常全局捕获方法

在 JavaScript 中，async 函数内未捕获的 Promise 拒绝会悄然“逃逸”为全局异常，而 `unhandledrejection` 事件正是捕获这类“漏网”异步错误的关键防线：浏览器可通过 `window.addEventListener`、Node.js（v15+）则用 `process.on` 统一监听，获取拒绝原因和原始 Promise 对象，实现错误上报、日志记录或用户提示；但需注意它仅对真正未处理的异步拒绝生效，无法替代函数内部的 `try/catch`，也不覆盖 `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 时触发），用于检测“延迟捕获”行为：

• 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 —— 它们永远不会触发此事件

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~