Shared Worker 是唯一能实现多标签页共用单点 WebSocket 心跳的机制,其核心是将心跳逻辑完全下沉至独立线程,确保页面失焦或后台时仍持续保活;需在 shared-worker.js 中实现定时 ping、pong 响应校验、状态广播、指数退避重连及兼容性降级。

Shared Worker 是目前浏览器中唯一能真正实现多窗口、多标签页共用单点 WebSocket 心跳的机制。它的核心价值不在于“共享连接”本身,而在于把心跳这个关键保活动作彻底收束到一个不受页面活跃状态影响的独立线程里——只要还有一个同源页面开着,心跳就持续运行,连接就不掉线,也不误判。
心跳逻辑必须完全下沉到 SharedWorker 内部
页面主线程的 setInterval 在切后台、失焦、低电量或执行缓慢时会被浏览器大幅降频甚至冻结(Chrome 后台 tab 通常冻结在 1s 以上,Safari 更激进)。一旦心跳停摆,服务端就会在几十秒内关闭连接。
- 所有心跳代码必须写死在 shared-worker.js 中:例如
setInterval(() => ws?.send("ping"), 30000) - 服务端必须返回标准 Pong 帧(RFC 6455 规范),不能用业务消息代替
- Worker 内需记录每次发送 ping 的时间戳,并在收到 pong 后更新 lastPongTime
- 连续两次未在 45 秒内收到 pong,主动 ws.close() 并触发重连流程
- 所有 WebSocket 回调(onopen/onmessage/onerror)都加 try...catch,防止异常导致整个 Worker 崩溃
单点心跳 + 全局状态广播,避免多端雪崩
多个页面各自发心跳,不仅浪费带宽,还容易因服务端频控、连接复位引发连锁断连。SharedWorker 要同时承担“心跳出口”和“状态中枢”双重角色。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本,主要优化了连接稳定性与数据传输效率。它通过全双工通信机制,允许客户端与服务器在单一长连接上实时交换数据,大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力,适用于即时通讯、在线游戏及金融行情推送等低延迟场景,为开发者提供更可靠的实时网络交互基础。
- 心跳成功、重连中、已断开等状态,统一通过 port.postMessage({ type: "status", state: "connected" }) 推送给所有已连接页面
- 页面 UI 只监听该消息并更新指示器(如小圆点颜色),禁止自行轮询或判断连接状态
- 禁止页面在 beforeunload 或 visibilitychange 中尝试发心跳或重连——这些全部交由 Worker 统一调度
- 页面关闭前应主动发送 { type: "disconnect", clientId },Worker 清理映射但不关连接(其他标签页还在用)
心跳必须与连接生命周期强绑定
心跳不是孤立的定时任务,它要驱动连接状态演进,否则只是空跑。
- WebSocket 实例必须在 SharedWorker 脚本内创建且仅初始化一次;重复 new 前先检查 ws?.readyState === WebSocket.CLOSED
- 每次发 ping 前校验 ws.readyState === WebSocket.OPEN,避免无效发送
- 心跳包建议轻量:用空 payload 的标准 Ping 帧,或带最小上下文(如
{"type":"ping","ts":1745786820123}) - 服务端返回的业务消息若含 "keepalive_ack" 字段,Worker 可视作一次有效心跳响应,延长下次检测窗口
- 重连采用指数退避:1s → 2s → 4s → …… 上限 30s,防止多个存活页面同时触发重连请求
兼容性兜底与资源闭环不可少
SharedWorker 在 Safari 旧版本(iOS 15.4 及更早)、部分安卓 WebView 中支持不完整,需主动识别并降级。
- 可通过 UA 检测或 try/catch new SharedWorker() 判断是否可用,不可用时 fallback 到 BroadcastChannel + 页面级节流策略
- Worker 内不操作 DOM、不访问 localStorage,只用 self 和 postMessage 通信,保持轻量纯净
- 每个页面首次通信时生成唯一 clientId(推荐 crypto.randomUUID()),Worker 用 Map 维护 clientId → port 映射,确保消息精准路由
- 页面监听 pagehide 或 beforeunload 时调用 port.close(),加速 Worker 端清理,避免无效心跳持续发送

















