Web/API/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

Specification	Status	Comment
HTML Living StandardThe definition of 'BroadcastChannel.onmessage' in that specification.	Living Standard	Initial definition.

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`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