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 asfunction(event) {...}
. An event handler always has one single parameter, containing the event, here of typeMessageEvent
.
Example
bc.onmessage = function(ev) { console.log(`message event received! '${ev.data}'`); };
Specifications
Specification | Status | Comment |
---|---|---|
HTML Living Standard The definition of 'BroadcastChannel.onmessage' in that specification. |
Living Standard | Initial definition. |
Browser compatibility
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.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
onmessage | Chrome Full support 54 | Edge Full support ≤79 | Firefox Full support 38 | IE No support No | Opera Full support 41 | Safari No support No | WebView Android Full support 54 | Chrome Android Full support 54 | Firefox Android ? | Opera Android Full support 41 | Safari iOS No support No | Samsung Internet Android Full support 6.0 |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
See also
- Another, more heavy weight, way of communicating between browser contexts:
ServiceWorker