Shared Worker 的核心价值是让同源多标签页共享唯一后台线程,实现真正跨页面后台状态与逻辑复用;需严格同源、HTTPS/localhost、独立脚本文件,页面端必须调用 port.start() 启动通信,Worker 端通过 onconnect 统一管理端口与共享状态。

Shared Worker 的核心价值,就是让同源下的多个标签页、iframe 或窗口共享同一个后台线程实例。它不是“多个线程协作”,而是“唯一一个线程服务所有页面”——这才是真正意义上的跨标签页后台共享。
必须满足的基础条件
- 协议、域名、端口三者完全一致(严格同源)
- 只能在 HTTPS 或
localhost环境下运行(HTTP 页面中会静默失败) - Worker 脚本必须是独立的
.js文件,不能是内联脚本、data URL 或 blob URL - Safari 需 16.4+(2023 年初起支持),旧版本需降级 fallback(如 BroadcastChannel + localStorage)
页面端:正确连接并启动通信
每个页面都要执行以下三步,缺一不可:
- 调用
new SharedWorker('worker.js')创建连接 - 获取
worker.port,绑定onmessage或addEventListener('message', ...) -
显式调用
port.start()—— 这是最常被忽略的关键步骤,不调用则消息通道处于暂停状态,收不到任何响应
示例代码:
const worker = new SharedWorker('/workers/shared-state.js');
const port = worker.port;
port.onmessage = (e) => {
console.log('收到广播:', e.data);
};
port.start(); // ⚠️ 必须写在这里
Worker 端:统一管理连接与状态
Worker 脚本需监听 self.onconnect,对每个新连接的页面端口做两件事:
- 调用
port.start()启用该端口通信 - 绑定
port.onmessage处理来自该页面的消息
所有页面共用同一全局作用域,因此:
-
let count = 0、const cache = new Map()这类顶层变量天然共享 - 但 JavaScript 没有原子操作,
count++在多端口并发时可能丢失更新 - 建议用简单标记位控制写入,或把变更封装成队列顺序处理
常见可靠写法:
let state = { count: 0, theme: 'light' };
const ports = new Set();
self.onconnect = (e) => {
const port = e.ports[0];
ports.add(port);
port.start();
port.onmessage = (msg) => {
const { type, key, value } = msg.data;
if (type === 'SET') {
state[key] = value;
// 广播给其他所有端口(不含当前发送者)
ports.forEach(p => p !== port && p.postMessage({ type: 'UPDATE', key, value }));
}
};
};
典型实用场景
- WebSocket 连接复用:Worker 内维持唯一 WebSocket 实例,所有页面通过它收发消息,避免多标签页重复建连、消息错乱
-
登录态同步:一个标签页退出登录,Worker 广播
LOGOUT,其余页面自动跳转或清空本地状态 -
实时计数器/在线人数:各页面上报
JOIN/LEAVE,Worker 统一维护并广播最新值 - API 请求代理:首次请求后缓存结果(如用户信息、配置项),后续页面直接读取,减少冗余请求
注意持久性与兼容边界
- Shared Worker 不保存数据,关闭所有标签页后实例即销毁;关键状态建议落地 IndexedDB 或由服务端兜底
- 它不能访问 DOM、localStorage、document 或 window,也不能触发 alert 或操作样式
- 若需 fallback,可检测
typeof SharedWorker === 'undefined',切换为 BroadcastChannel + 时间戳协调机制
不复杂但容易忽略











