BroadcastChannel: postMessage() 方法

基线 2022

新推出

2022 年 3 月起,此功能适用于最新的设备和浏览器版本。此功能可能无法在较旧的设备或浏览器中使用。

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

BroadcastChannel 接口的 postMessage() 方法发送一条消息,该消息可以是任何类型的 Object,发送到任何具有相同 来源浏览上下文 中的每个监听器。消息以 message 事件的形式传输,该事件的目标是绑定到该通道的每个 BroadcastChannel

语法

js
postMessage(message)

参数

message

要发送到其他窗口的数据。数据使用 结构化克隆算法 进行序列化。这意味着您可以将各种数据对象安全地传递到目标窗口,而无需自行对其进行序列化。

返回值

无。

异常

InvalidStateError DOMException

如果 BroadcastChannel 已经关闭,则抛出该异常。

DataCloneError DOMException

如果输入数据的任何部分无法序列化,则抛出该异常。

规范

规范
HTML 标准
# dom-broadcastchannel-postmessage-dev

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参见