W3cubDocs

/Web APIs

BroadcastChannel.onmessage

The BroadcastChannel.onmessage event handler is a property that specifies the function to execute when a message event, of type MessageEvent, is received by this BroadcastChannel. Such an event is sent by the browser with a message broadcasted to the channel.

Note: This feature is available in Web Workers

Syntax

channel.onmessage = function;

Values

  • function is the name of a user-defined function, without the () suffix or any parameters, or an anonymous function declaration, such as function(event) {...}. An event handler always has one single parameter, containing the event, here of type MessageEvent.

Example

bc.onmessage = function(ev) { console.log(`message event received! '${ev.data}'`); };

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
onmessage
54
79
38
No
41
preview
54
54
38
41
No
6.0

See also

  • Another, more heavy weight, way of communicating between browser contexts: ServiceWorker

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/BroadcastChannel/onmessage