Shared Worker 是解决“一个服务端推送,多个页面同时响应”问题的天然方案;它通过主页面授权、Worker 统一分发、客户端 ID 管理及兼容性降级,实现跨页面通知精准广播与生命周期控制。
shared worker 是解决“一个服务端推送,多个页面同时响应”问题的天然方案。它不依赖服务器改造,也不需要轮询或额外长连接,只要同源、安全上下文就可运行。
核心逻辑:权限由主页面申请,消息由 Worker 统一分发
Notification API 只能在 window 上下文中调用,Shared Worker 无法直接弹窗。所以必须让首个加载的页面完成授权,并把 权限状态 和 PushSubscription 对象传给 Worker。
- 主页面首次加载时调用
Notification.requestPermission() - 获得许可后,用
pushManager.subscribe()获取订阅信息 - 通过
worker.port.postMessage({ type: 'init', permission: 'granted', subscription })把关键数据传入 Worker - Worker 内部缓存该 subscription,后续所有通知都基于它触发
消息接收与广播的关键控制点
服务端推送(如通过 Web Push 协议、EventSource 或 WebSocket)到达前端后,不能直接在页面里处理,否则每个窗口都会重复解析、重复弹窗。应统一交由 Shared Worker 处理。
- Worker 收到推送消息后,先校验内容结构和有效性
- 若为全局通知(如系统公告),调用
ports.forEach(port => port.postMessage(...))广播给所有活跃页面 - 若为定向消息(如用户私信、订单更新),需携带
targetClientId字段,Worker 查表匹配唯一 port 后精准投递 - 每个页面监听自己的 port 消息,收到后调用
new Notification(...)显示,无需再次申请权限
客户端 ID 管理与连接生命周期
多个窗口共用一个 Worker,但不能混淆各自身份。每个页面必须在连接初期上报唯一标识,Worker 才能做路由和清理。
- 页面初始化时生成 clientId:
crypto.randomUUID()(推荐),或兼容旧版的Date.now() + Math.random().toString(36).substr(2, 9) - 连接建立后立即发送
{ type: "register", clientId: "win-abc123" } - Worker 用 Map 存储
clientId → port映射,并在port.onclose或页面主动发{ type: "unregister" }时及时清除 - 页面关闭前未清理会导致内存泄漏,且后续同名 clientId 可能被错误路由
兼容性与降级建议
Shared Worker 在 Safari 中仅支持 macOS 13.3+ / iOS 16.4+;部分旧安卓 WebView 或低版本 Chrome 也不支持。上线前需有 fallback 方案。
- 检测是否支持:
if (typeof SharedWorker !== 'undefined') - 不支持时,退回到单页独立维护 PushManager + 本地广播(BroadcastChannel)同步状态
- 开发阶段务必使用
http://localhost或https://,file://协议会静默失败 - Worker 脚本必须是独立 .js 文件,不可内联,且需正确设置 MIME 类型

















