Chrome 131 控制台告警 unload 将弃用 怎么改成 pagehide

现象

项目在 Chrome 131 的控制台里出现一条弃用告警:Unload event listeners are deprecated and will be removed。同时页面正用 unload 上报离开埋点,数据开始丢失,部分用户的行为路径在后台断掉,Safari 上也提示过类似信息。

原因

unload 会阻止浏览器把页面放进往返缓存,直接影响前进后退的性能,Chrome 从 117 开始逐步弃用,131 起直接在控制台告警。这个事件在移动端本来就不保证触发,进程被系统回收时根本不会执行,埋点丢失是必然结果。

解决步骤

第一步,把 unload 换成 pagehide。pagehide 在进入缓存和真正销毁时都会触发,用 event.persisted 区分两种情况,需要上报时一起带上这个字段。

window.addEventListener("pagehide", (e) => {
  const payload = JSON.stringify({
    path: location.pathname,
    persisted: e.persisted
  });
  navigator.sendBeacon("/api/leave", payload);
});

第二步,请求改用 sendBeacon。页面关闭过程中普通 XHR 会被中断,sendBeacon 由浏览器接管投递,fetch 也可以但要显式加 keepalive:true。

第三步,清理只在销毁时做的事。断开 WebSocket、停止定时器这类清理逻辑同样搬到 pagehide 里,不要依赖 unload 和 beforeunload,后者还会弹确认框影响体验。

验证

在 Chrome 131 打开控制台,确认弃用告警消失;切换标签页、关闭页面各测一次,Network 面板里应能看到 leave 请求正常发出并返回 200。

小结

unload 被弃用是趋势,pagehide 加 sendBeacon 是官方推荐的替代组合。事件换成 pagehide、上报换成 beacon、清理逻辑一起搬,埋点才不会继续丢。

您可以还会对下面的文章感兴趣:

暂无相关文章