The onmessage property of the ServiceWorkerGlobalScope
interface is an event handler fired whenever a message
event occurs — when incoming messages are received.
Note: Service workers define the extendable event to allow extending the lifetime of the event. For the message
event, service workers use the ExtendableMessageEvent
interface which extends the ExtendableEvent
interface.
Note: Messages received from service worker contexts (e.g. as the event object of onmessage
) are represented by MessageEvent
objects in modern browsers, for consistency with other web messaging features. (They used to be represented by ServiceWorkerMessageEvent
objects, which have now been deprecated.)
serviceWorkerGlobalScope.onmessage = function(extendableMessageEvent) { ... };
self.addEventListener('message', function(messageEvent) { console.log('Handling message event:', messageEvent); })
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
onmessage |
40 |
17 |
44
Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.
|
No |
24 |
11.1 |
40 |
40 |
44 |
24 |
11.3 |
4.0 |
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorkerGlobalScope/onmessage