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
functionis 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
