onerror事件在页面卸载前失效,因浏览器中止异步任务和未完成请求;应改用pagehide中调用navigator.sendBeacon发送错误日志,并配合全局错误队列缓存与去重,确保上报可靠性。

页面卸载前onerror事件失效的原因
浏览器在页面即将刷新或关闭时,会中止大部分异步任务和未完成的网络请求。onerror 本身是同步触发的,但如果你在其中发起 fetch、XMLHttpRequest 或调用 console.error 后立刻刷新,这些操作大概率被丢弃——尤其 fetch 默认是非持久化(non-keepalive)的,没有显式配置就发不出去。
用navigator.sendBeacon替代fetch发送错误日志
sendBeacon 是专为卸载场景设计的 API,它能保证在页面不可见前把数据发出,且不阻塞卸载流程。关键点:
- 只支持
POST,数据类型限于ArrayBuffer、Blob、FormData、URLSearchParams或字符串 - 必须在
beforeunload或pagehide中调用(unload已被多数浏览器禁用) - 不能依赖响应,它只管发,不等回执
示例写法:
window.addEventListener('pagehide', () => {
if (window.errorLogQueue && window.errorLogQueue.length > 0) {
const payload = JSON.stringify({ errors: window.errorLogQueue });
navigator.sendBeacon('/api/log', new Blob([payload], { type: 'application/json' }));
}
});
全局onerror + 队列缓存,避免丢失中间错误
直接在 onerror 里调用 sendBeacon 不可靠:频繁报错时可能多次触发,而 sendBeacon 并发能力弱,还可能被节流。更稳妥的是先缓存,再统一发:
立即学习“前端免费学习笔记(深入)”;
- 声明一个全局数组
window.errorLogQueue = [],在window.onerror和window.addEventListener('unhandledrejection')中往里推结构化错误对象 - 错误对象至少包含
message、filename、lineno、colno、error.stack(如果有) - 注意过滤掉重复错误(例如同一行连续报错),可用
message + lineno + colno做简易去重键
别忘了捕获 Promise 错误:
window.addEventListener('unhandledrejection', e => {
window.errorLogQueue.push({
type: 'unhandledrejection',
reason: e.reason?.toString() || 'unknown',
stack: e.reason?.stack || ''
});
});
为什么不能只靠beforeunload监听刷新动作
beforeunload 的主要用途是提示用户“你有未保存内容”,不是用来做日志上报的。它的执行受严格限制:
- Chrome 等现代浏览器已禁止在其中执行耗时操作或发起非
sendBeacon请求 - 用户快速刷新(如 Ctrl+R)可能跳过该事件,尤其在页面刚加载完就操作时
- 移动端 Safari 对
beforeunload支持极差,很多情况根本不触发
真正可靠的兜底时机是 pagehide,它在页面进入后台/卸载前必达(除极端进程 kill 外)。如果要兼容老 IE,只能降级用 unload + img.src 打点(但成功率很低,仅作备选)。
复杂点在于错误上下文容易被 GC 掉,比如 error.stack 在事件回调结束后可能失效;所以拿到错误后要立刻深拷贝关键字段,别留引用。



















