BroadcastChannel
Baseline 2022
Newly available
The BroadcastChannel
interface represents a named channel that any browsing context 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, except the object that sent the message.
EventTarget BroadcastChannel
Constructor
BroadcastChannel()
Creates an object linking to the named channel.
Instance properties
This interface also inherits properties from its parent, EventTarget
.
BroadcastChannel.name
Read only
Returns a string, the name of the channel.
Instance methods
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.
Events
This interface also inherits events from its parent, EventTarget
.
message
Fired when a message arrives on the channel. Also available via the onmessage
property.
messageerror
Fired when a message arrives that can't be deserialized. Also available via the onmessageerror
property.
Specifications
Browser compatibility
Desktop
Mobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on IOS
Samsung Internet
WebView Android
BroadcastChannel
54
79
38
41
15.4
54
38
41
15.4
6.0
54
BroadcastChannel
54
79
38
41
15.4
54
38
41
15.4
6.0
54
close
54
79
38
41
15.4
54
38
41
15.4
6.0
54
message_event
54
79
38
41
15.4
54
38
41
15.4
6.0
54
messageerror_event
60
79
57
47
15.4
60
57
47
15.4
8.0
60
name
54
79
38
41
15.4
54
38
41
15.4
6.0
54
postMessage
54
79
38
41
15.4
54
38
41
15.4
6.0
54
See also