Web/API/DedicatedWorkerGlobalScope/message event

From Get docs


The message event is fired on a DedicatedWorkerGlobalScope object when the worker receives a message from its parent (i.e. when the parent sends a message using Worker.postMessage()).

Bubbles No
Cancelable No
Interface MessageEvent
Event handler property onmessage

Examples

This code creates a new worker and sends it a message using Worker.postMessage():

const worker = new Worker("static/scripts/worker.js");

worker.addEventListener('message', (event) => {
    console.log(`Received message from worker: ${event.data}`)
});

The worker can listen for this message using addEventListener():

// inside static/scripts/worker.js

self.addEventListener('message', (event) => {
    console.log(`Received message from parent: ${event.data}`);  
});

Alternatively, it could listen using the onmessage event handler property:

// static/scripts/worker.js

self.onmessage = (event) => {
    console.log(`Received message from parent: ${event.data}`);  
};

Specifications

Specification Status
HTML Living Standard Living Standard

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
message event Chrome

Full support 4

Edge

Full support 12

Firefox

Full support 3.5

IE

Full support 10

Opera

Full support 10.6

Safari

Full support 4

WebView Android

Full support 37

Chrome Android

Full support Yes

Firefox Android

Full support 4

Opera Android

Full support 11.5

Safari iOS

Full support 5.1

Samsung Internet Android

Full support Yes

Legend

Full support  
Full support


See also

  • Related events: messageerror.
  • Worker.postMessage().