BroadcastChannel

Baseline 已广泛支持

此特性已经十分成熟，可在许多设备和浏览器版本上使用。自 2022 年 3 月起，它已在各浏览器中可用。

注意：此功能在 Web Workers 中可用。

BroadcastChannel 接口代表一个命名的频道，同一源的任何浏览上下文都可以订阅它。它允许同一源的不同文档（在不同的窗口、标签页、框架或 iframe 中）之间进行通信。消息通过发送到监听该频道的每个 BroadcastChannel 对象（除了发送消息的对象本身）的 message 事件进行广播。

构造函数

BroadcastChannel(): 创建一个链接到命名频道的对象。

实例属性

此接口还继承了其父接口 EventTarget 的属性。

BroadcastChannel.name 只读: 返回一个字符串，即频道的名称。

实例方法

此接口还继承了其父接口 EventTarget 的方法。

BroadcastChannel.postMessage(): 将任何类型的对象消息发送到监听同一频道的每个 BroadcastChannel 对象。
BroadcastChannel.close(): 关闭频道对象，表示它不会接收新消息，并允许它最终被垃圾回收。

事件

此接口还继承了其父接口 EventTarget 的事件。

message: 当频道收到消息时触发。也可通过 onmessage 属性访问。
messageerror: 当收到无法反序列化的消息时触发。也可通过 onmessageerror 属性访问。

规范

规范
HTML # 广播到其他浏览上下文

浏览器兼容性

另见

另一种更重量级的在浏览器上下文之间通信的方式：ServiceWorker。
Broadcast Channel API 概述

帮助改进 MDN

了解如何贡献

此页面最后修改于 2024年6月3日，由 MDN 贡献者修改。

在 GitHub 上查看此页面 • 报告此内容的错误