通过监听 unhandledrejection 事件可捕获未处理的 Promise 异常，需处理 event.reason 的类型多样性并封装错误信息，结合统一上报机制使用 navigator.sendBeacon 等方式提交至监控系统，保障前端稳定性。
在前端监控系统中，捕获未处理的 Promise 异常是保障应用稳定性的重要环节。这类异常往往不会触发传统的 window.onerror，因此需要专门监听特定事件来捕捉。
使用 unhandledrejection 事件
浏览器提供了 unhandledrejection 事件，专门用于监听未被 catch 的 Promise 异常。通过在全局 window 对象上绑定该事件，可以捕获所有未处理的 Promise 错误。
基本用法如下：
window.addEventListener('unhandledrejection', function(event) { // 阻止默认行为（避免控制台报错） event.preventDefault(); // 上报错误信息 const error = event.reason; console.error('Unhandled promise rejection:', error); // 可以上报到监控服务 reportErrorToServer({ type: 'promise', message: error?.message || 'Unknown error', stack: error?.stack, url: location.href }); });注意 event.reason 的类型
event.reason 并不总是 Error 实例，可能是字符串或其他值。为了统一处理，建议先判断其类型并封装成标准错误对象。
立即学习“前端免费学习笔记（深入）”；
- 如果 reason 是 Error 对象，直接提取 message 和 stack
- 如果是字符串，可创建新的 Error 对象包装它
- 对于其他类型，转换为字符串描述
示例处理逻辑：
const reason = event.reason; let errorInfo; if (reason instanceof Error) { errorInfo = { message: reason.message, stack: reason.stack }; } else { errorInfo = { message: String(reason), stack: undefined }; }结合现有监控体系上报
捕获到异常后，应将其纳入统一的错误上报机制。通常包括以下信息：
- 错误类型标记为 'unhandledrejection'
- 当前页面 URL
- 用户行为上下文（如最近的操作路径）
- 设备和环境信息（UA、版本等）
上报方式建议使用 navigator.sendBeacon 或异步 XMLHttpRequest，避免阻塞主线程。
基本上就这些。只要监听 unhandledrejection 事件并妥善处理 event.reason 的多样性，就能有效捕获前端未处理的 Promise 异常。这个机制简单但容易被忽略，尤其是在使用 async/await 而忘记 catch 时特别有用。
