“一个标签页退出登录,其他标签页还停留在登录态。”这类状态不同步的问题,可以用 BroadcastChannel 解决。它让同源的多个标签页、iframe 直接发消息,不需要经过服务端。
const channel = new BroadcastChannel('session');
channel.onmessage = (event) => {
console.log('收到', event.data);
};
channel.postMessage({ type: 'logout' });BroadcastChannel 按名称创建,同源、同名频道的页面都能收到消息。消息用结构化克隆传递,可以发对象、数组、Date,但不能发函数、DOM 节点或带循环引用的对象。postMessage 是异步的,发送后修改原对象,不会影响已发送的消息。
BroadcastChannel 是“即时广播”,没有历史记录。后打开的标签页收不到之前发过的消息;需要状态同步时,接收方要主动从 localStorage、IndexedDB 或服务端拉一次当前状态,再靠广播做增量通知。
它也不保证消息顺序跨频道,不同频道的消息互不影响。不要把它当消息队列用。MessageChannel 是一对一端口,适合 worker/iframe 定向通信;BroadcastChannel 是一对多广播,适合标签页之间通知。
BroadcastChannel 只在同源页面之间通信。https://app.example 和 https://admin.example 属于不同源,不能直接通;同源的 iframe 可以。
这也意味着,同一个浏览器 profile 下,不同账号访问同一个域名时共享频道。对多账号环境来说,广播不能按账号自动隔离;需要按 profile 隔离,或者在消息里带账号标识,接收方自行过滤。同源 iframe 可以收到广播,但跨源 iframe 不行;嵌入第三方页面时,不要指望它能加入你的频道。
如果页面有多个模块,频道名要带模块或版本前缀,比如 session:v1、theme:v1,避免不同模块互相收到无关消息。
一个典型用法是退出登录:一个标签页清 Cookie 并广播 { type: 'logout' },其他标签页收到后跳转登录页。不要只广播不清理本地状态,否则页面还在、token 还在,看起来像没退出。
storage 事件也能做跨标签通信,但它只在 localStorage 被修改时触发,且不会在当前标签页触发。BroadcastChannel 更直接,适合发“退出登录”“刷新配置”“切换主题”这类事件。
兼容性上,现代浏览器普遍支持 BroadcastChannel;如果要兼容很老的浏览器,可以用 storage 事件做降级,或者用 SharedWorker。
第一,忘记 close()。页面卸载时关闭频道,避免重复监听和内存泄漏。
第二,重复注册 onmessage。单页应用切换路由时,先移除旧监听,再注册新的。
第三,发送敏感数据。同源脚本都能监听频道,不要在里面传 token、密码;需要传身份时,用一次性凭证或服务端校验。
第四,把广播当可靠存储。消息丢了就丢了,关键状态要有持久化兜底。
BroadcastChannel 适合做同源标签页之间的轻量事件通知:退出登录、配置更新、主题切换。它不保存消息、不跨源、不按账号隔离;用它做状态同步时,记得先拉一次全量状态,再用广播做增量,最后用持久化存储兜底。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。