在此页

• 构造函数
• 特性
• 方法
• 事件
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

BroadcastChannel interface represents a named channel that any 浏览上下文 of a given origin can subscribe to. It allows communication between different documents (in different windows, tabs, frames or iframes) of the same origin. Messages are broadcasted via a message event fired at all BroadcastChannel objects listening to the channel.

注意： 此特征可用于 Web 工作者 .

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="../API/EventTarget.html" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/BroadcastChannel" target="_top"><rect x="151" y="1" width="160" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="231" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">BroadcastChannel</text></a></svg></div>
					

  a:hover text { fill: #0095DD; pointer-events: all;}
					

构造函数

BroadcastChannel()

Creates an object linking to the named channel.

特性

This interface also inherits properties from its parent, EventTarget .

BroadcastChannel.name 只读

返回 DOMString , the name of the channel.

事件处理程序

BroadcastChannel.onmessage

EventHandler property that specifies the function to execute when a message event is fired on this object.

BroadcastChannel.onmessageerror

EventHandler 被调用当 MessageEvent 类型 MessageError is fired—that is, when it receives a message that cannot be deserialized.

方法

This interface also inherits methods from its parent, EventTarget .

BroadcastChannel.postMessage()

Sends the message, of any type of object, to each BroadcastChannel object listening to the same channel.

BroadcastChannel.close()

Closes the channel object, indicating it won't get any new messages, and allowing it to be, eventually, garbage collected.

事件

message

Fired when when a message arrives on the channel.
也可用凭借 onmessage 特性。

messageerror

Fired when a message arrives that can't be deserialized.
也可用凭借 onmessageerror 特性。

规范

规范	状态	注释
HTML 实时标准 The definition of 'BroadcastChannel' in that specification.	实时标准	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
BroadcastChannel	Chrome 54	Edge ≤79	Firefox 38	IE No	Opera 41	Safari No	WebView Android 54	Chrome Android 54	Firefox Android ?	Opera Android 41	Safari iOS No	Samsung Internet Android 6.0
BroadcastChannel() 构造函数	Chrome 54	Edge ≤79	Firefox 38	IE No	Opera 41	Safari No	WebView Android 54	Chrome Android 54	Firefox Android ?	Opera Android 41	Safari iOS No	Samsung Internet Android 6.0
close	Chrome 54	Edge ≤79	Firefox 38	IE No	Opera 41	Safari No	WebView Android 54	Chrome Android 54	Firefox Android ?	Opera Android 41	Safari iOS No	Samsung Internet Android 6.0
message event	Chrome 54	Edge ≤79	Firefox 38	IE No	Opera 41	Safari No	WebView Android 54	Chrome Android 54	Firefox Android ?	Opera Android 41	Safari iOS No	Samsung Internet Android 6.0
messageerror event	Chrome 60	Edge ≤79	Firefox 57	IE No	Opera 47	Safari No	WebView Android 60	Chrome Android 60	Firefox Android ?	Opera Android 47	Safari iOS No	Samsung Internet Android 8.0
名称	Chrome 54	Edge ≤79	Firefox 38	IE No	Opera 41	Safari No	WebView Android 54	Chrome Android 54	Firefox Android ?	Opera Android 41	Safari iOS No	Samsung Internet Android 6.0
onmessage	Chrome 54	Edge ≤79	Firefox 38	IE No	Opera 41	Safari No	WebView Android 54	Chrome Android 54	Firefox Android ?	Opera Android 41	Safari iOS No	Samsung Internet Android 6.0
onmessageerror	Chrome 60	Edge ≤79	Firefox 57	IE No	Opera 47	Safari No	WebView Android 60	Chrome Android 60	Firefox Android ?	Opera Android 44	Safari iOS No	Samsung Internet Android 8.0
postMessage	Chrome 54	Edge ≤79	Firefox 38	IE No	Opera 41	Safari No	WebView Android 54	Chrome Android 54	Firefox Android ?	Opera Android 41	Safari iOS No	Samsung Internet Android 6.0

图例

完整支持

完整支持

不支持

不支持

兼容性未知 ?

兼容性未知

另请参阅

• Another, more heavyweight, way of communicating between browser contexts: ServiceWorker .
• Broadcast Channel API overview

元数据

• 最后修改： Jun 5, 2020

相关话题

1. 广播通道 API
2. BroadcastChannel
3. 构造函数

   1. BroadcastChannel()
4. 特性

   1. 名称
   2. onmessage
   3. onmessageerror
5. 方法

   1. close()
   2. postMessage()
6. 事件

   1. message
   2. messageerror
7. 继承：

   1. EventTarget