Service Workers APIservice
The messageerror event of the ServiceWorkerGlobalScope interface occurs when incoming messages can't be deserialized.
This event is not cancelable and does not bubble.
Syntax
Use the event name in EventTarget/addEventListener:
addEventListener("messageerror", (event) => { })
Alternatively, assign to the event handler property of the interface:
onmessageerror = (event) => { }
Event type
An ExtendableMessageEvent. Inherits from ExtendableEvent.
ExtendableMessageEvent
Examples
In the below example a page gets a handle to the ServiceWorker object via ServiceWorkerRegistration.active, and then calls its postMessage() function.
// main.js
if (navigator.serviceWorker) {
navigator.serviceWorker.register("service-worker.js");
navigator.serviceWorker.addEventListener("message", (event) => {
// event is a MessageEvent object
console.log(`The service worker sent me a message: ${event.data}`);
});
navigator.serviceWorker.ready.then((registration) => {
registration.active.postMessage("Hi service worker");
});
}
The service worker can listen for the message deserialization error by listening to the messageerror event:
// service-worker.js
self.addEventListener("messageerror", (event) => {
// event is an ExtendableMessageEvent object
console.error("Message deserialization failed");
});
Alternatively, the script can listen for the message deserialization error using onmessageerror (but note that this replaces other event listeners added using onmessageerror, if any):
// service-worker.js
self.onmessageerror = (event) => {
// event is an ExtendableMessageEvent object
console.error("Message deserialization failed");
};
Specifications
Browser compatibility
See also
- ServiceWorkerGlobalScope/message_event
- ServiceWorker.postMessage()
- Using Service Workers
- Service workers basic code example
- Using web workers
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
