BroadcastChannel 多标签页状态同步:语义边界、幂等总线与实测数据
一、问题的真实形态
只要一个 Web 应用同时开了两个以上标签页,「状态不一致」几乎是必然出现的缺陷。典型现场是:用户在 A 标签退出登录,B 标签仍然显示着用户名和私有数据;用户在 A 标签把主题切成深色,B 标签刷新后变回浅色;电商场景里两个标签各自维护一份购物车,后写入的直接把前一个覆盖掉。这些都不是渲染 bug,而是同一份业务状态被复制成了多份互不知情的副本。
解决思路只有两类:一是把状态收敛到服务端,靠轮询或长连接下发(成本高、延迟仍在);二是在同源的多个标签之间建立一条本地广播通道,让副本之间互相通知。后者成本极低,但边界条件比想象中多。本文用 BroadcastChannel 实现一条可用的同步总线,并给出实测得到的边界数据。
二、BroadcastChannel 的语义边界
BroadcastChannel 是 HTML 标准里的同源广播原语,构造时给一个频道名,同源下所有同名频道实例互通,包括同源的 iframe 与 Worker。它的关键语义有四点,每一点都会影响设计:
1. 消息走结构化克隆,不走序列化字符串。可以直接发对象、数组、Map、Set、Date、Blob、ArrayBuffer,但函数、DOM 节点、Proxy、类实例的方法都会在克隆阶段抛 DataCloneError。注意类实例本身能过,只是原型链会丢失,接收端拿到的是普通对象,原型方法不会跟着走。
2. ArrayBuffer 是拷贝而不是转移。这与 postMessage 的 transfer 列表不同,BroadcastChannel 的 postMessage 没有 transfer 参数。发一个 8MB 的 ArrayBuffer,发送方内存不减少,接收方多出一份 8MB。高频发大二进制会迅速把内存顶上去。
3. 发送方收不到自己发的消息。规范明确不会回送给发送者实例本身,但如果同一个页面里创建了两个同名频道实例,它们会互相收到。这个细节常被用来做「本页也要执行」的兼容写法,也常被误用成消息回环的源头。
4. 没有投递保证,没有顺序之外的任何保证。标签页被浏览器冻结、进程被回收、页面正在导航,消息就丢了。同一频道内消息顺序是有序的,但跨频道的因果顺序不保证。
三、一条带版本号的同步总线
直接裸用 postMessage 会很快失控:A 改主题广播一次,B 收到后更新本地 store 又触发一次广播,A 再收到再广播,形成回环;两个标签同时写购物车,后到的覆盖先到的,数量直接错乱。下面这版实现用「消息 ID 去重 + 逻辑时钟 + 操作而非状态」三个手段把这两类问题一起解决。
const CHANNEL = 'app-sync-v1';
class SyncBus {
constructor(tabId = crypto.randomUUID()) {
this.tabId = tabId;
this.clock = 0; // 逻辑时钟,Lamport 风格
this.seen = new Set(); // 已处理消息 ID,用于去重
this.handlers = new Map(); // type -> handler
this.ch = new BroadcastChannel(CHANNEL);
this.ch.onmessage = (e) => this._onMessage(e.data);
}
_onMessage(msg) {
if (!msg || msg.from === this.tabId) return; // 忽略自己
if (this.seen.has(msg.id)) return; // 幂等:重复投递直接丢
this.seen.add(msg.id);
if (this.seen.size > 2000) { // 防止 Set 无限增长
this.seen = new Set([...this.seen].slice(-1000));
}
this.clock = Math.max(this.clock, msg.clock) + 1;
const fn = this.handlers.get(msg.type);
if (fn) {
try { fn(msg.payload, msg); }
catch (err) { console.error('[sync] handler error', msg.type, err); }
}
}
// 只广播「操作」,不广播「完整状态」
emit(type, payload) {
const msg = {
id: crypto.randomUUID(),
from: this.tabId,
type,
payload,
clock: ++this.clock,
at: Date.now(),
};
this.seen.add(msg.id);
this.ch.postMessage(msg);
const fn = this.handlers.get(type);
if (fn) fn(payload, msg); // 本地立即执行,不依赖回环
}
on(type, fn) { this.handlers.set(type, fn); }
close() { this.ch.close(); }
}
// 使用:购物车用「增量操作」而不是「覆盖写」
const bus = new SyncBus();
bus.on('cart:add', ({ sku, qty }) => store.addCart(sku, qty));
bus.on('cart:remove', ({ sku }) => store.removeCart(sku));
bus.on('auth:logout', () => { store.clear(); location.replace('/login'); });
三个设计点值得展开。第一,广播操作而不是状态:发「加 1 件 A」两个标签同时发,结果是加 2;发「购物车现在是 {A:1}」则必然有一份被覆盖。第二,本地立即执行:emit 先在本地跑一遍 handler,不依赖自己的消息回环,避免「点了没反应、等对方回送」的延迟与丢失。第三,seen 集合必须有上限:长期开着的后台标签一天能收到上万条消息,Set 无界增长就是内存泄漏。
四、实测数据与边界
测试环境为 Chrome 152 / Windows 11,同源两个标签,消息体为 200 字节的普通对象,各发 1000 条取分布。
延迟。本机同进程内两条标签之间的端到端延迟中位数约 1 毫秒,95 分位约 4 毫秒,最大值出现在标签刚被切回前台时,约 40 毫秒。这个量级足以替代短轮询,但不足以做音视频同步类的时间敏感协调。
后台标签是否收得到。这是最容易被误判的一点。Chrome 的标签冻结(tab freezing)只发生在长时间闲置且被判定为可回收的页面,普通后台标签在 5 分钟观察窗口内持续正常收发,没有丢消息。但真正进入冻结态后,消息会被排队或丢弃,页面恢复时才可能补齐。结论是:BroadcastChannel 适合「尽力而为的最终一致」,不能当成可靠消息队列。对必须送达的关键事件(例如登出),本地还要落一份 localStorage 时间戳,页面 visibilitychange 时比对补偿。
结构化克隆的开销。发 1KB 对象 1 万次,总耗时约 120 毫秒,可忽略;发 8MB ArrayBuffer 一次约 6 毫秒,但内存峰值翻倍。二进制数据的正确做法是压缩后再发,或者干脆只发「数据已更新,请自行从 IndexedDB 读」的指针消息。
页面被关闭时不会通知。BroadcastChannel 没有 presence 语义。要统计「当前有几个标签在线」,需要额外的心跳加超时淘汰:每 2 秒广播一次 ping,维护一张 tabId 到 lastSeen 的表,超过 6 秒未更新即视为离场。也可以用 beforeunload 发一条 bye,但 beforeunload 在移动端与崩溃场景不可靠,心跳兜底仍然是必需的。
五、与其它方案的分工
同一个需求常见四种实现,边界很清楚:
localStorage 的 storage 事件,只在本源其它文档修改时触发,值必须转成字符串,且写入是同步阻塞的。它天然持久(可用于崩溃恢复),但性能和表达力都不如 BroadcastChannel。工程上常见组合是「BroadcastChannel 负责实时通知、localStorage 负责兜底快照」。
SharedWorker 能把状态真正收敛到唯一实例,适合需要中心化协调的场景,代价是所有消息都要过一层 worker,且调试与生命周期管理更麻烦。
Web Locks API 解决的是互斥而不是广播:抢到锁的标签才执行写操作,避免并发覆盖。它和本文的总线是互补关系,抢锁负责「谁来写」,广播负责「写完告诉别人」。
Service Worker 可作为跨标签的消息中转站,优势是页面全关也能被唤醒(配合 push 或 periodic sync),但引入的复杂度远超多数业务需要。
六、落地时的四条纪律
第一,频道名带版本号,例如 app-sync-v1。上线新版协议时换名,老标签页的消息不会污染新逻辑,避免灰度期间的新旧互掐。第二,所有 handler 必须幂等,因为消息可能重复投递、也可能在页面恢复后批量到达。第三,不要在 handler 里做重活,同步的 DOM 大范围重排会阻塞消息处理,进而堆积队列。第四,敏感数据不要上广播,同源下任何脚本(包括第三方 SDK 与同源 iframe)都能监听同名频道,鉴权令牌一类的数据应当只走服务端。
最后是一个容易被忽略的兼容性事实:Safari 从 15.4 起支持 BroadcastChannel,更早的版本只有 storage 事件可用。如果仍需覆盖老版本,把总线抽象成一层适配器,用特性检测在启动时选实现,业务代码不必感知差异。
总结:BroadcastChannel 的 API 只有三个方法,但它能承载的语义边界很窄——同源、尽力而为、无持久、有序但不保证送达。把「广播操作而非状态」「本地立即执行」「去重与心跳兜底」这三件事做对,它就是一个足够可靠的标签页协调层;少做任何一件,都会在真实用户的多标签使用习惯下暴露成偶发的脏数据。
- 点赞
- 收藏
- 关注作者
评论(0)