This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use 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 spec 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 | Not supported | 38 (38) | Not supported | Not supported | Not supported |
| Available in workers | Not supported | 38 (38) | Not supported | Not supported | Not supported |
| Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | Not supported | Not supported | 38.0 (38) | Not supported | Not supported | Not supported |
| Available in workers | Not supported | Not supported | 38.0 (38) | Not supported | Not supported | Not supported |
See also
- Another, more heavy weight, way of communicating between browser contexts:
ServiceWorker