This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
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!"); };
Specifications
| Specification | Status | Comment |
|---|---|---|
| WHATWG HTML Living Standard The definition of 'BroadcastChannel.onmessage' in that specification. |
Living Standard | Initial definition. |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | 54.0 | 38 (38) | No support | 41 | No support |
| Available in workers | 54.0 | 38 (38) | No support | 41 | No support |
| Feature | Android | Android Webview | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
|---|---|---|---|---|---|---|---|
| Basic support | No support | No support | 38.0 (38) | No support | 41 | No support | 54.0 |
| Available in workers | No support | No support | 38.0 (38) | No support | 41 | No support | 54.0 |
See also
- Another, more heavy weight, way of communicating between browser contexts:
ServiceWorker