ServiceWorkerContainer:messageerror 事件
注意:此功能在 Web Workers 中可用。
当发送到相关工作线程的传入消息无法反序列化时,会向 ServiceWorkerContainer 触发 messageerror 事件。
此事件不可取消,也不会冒泡。
语法
在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。
js
addEventListener("messageerror", (event) => { })
onmessageerror = (event) => { }
事件类型
一个 MessageEvent。继承自 Event。
事件属性
此接口还继承了其父级 Event 的属性。
MessageEvent.data只读-
由消息发送者发送的数据。
MessageEvent.origin只读-
一个字符串,表示消息发送者的源。
MessageEvent.lastEventId只读-
一个字符串,表示事件的唯一 ID。
MessageEvent.source只读-
一个
MessageEventSource(可以是 WindowProxy、MessagePort或ServiceWorker对象),表示消息发送者。 MessageEvent.ports只读-
一个
MessagePort对象数组,表示消息发送通道(如果适用,例如在通道消息传递或向共享工作者发送消息时)关联的端口。
示例
在此示例中,服务工作线程从 fetch 事件获取客户端 ID,然后使用 Client.postMessage 向其发送消息。
js
// service-worker.js
async function messageClient(clientId) {
const client = await self.clients.get(clientId);
client.postMessage("Hi client!");
}
self.addEventListener("fetch", (event) => {
messageClient(event.clientId);
event.respondWith(() => {
// …
});
});
服务工作线程可以通过监听 messageerror 事件来监听消息反序列化错误。
js
// main.js
navigator.serviceWorker.addEventListener("messageerror", (event) => {
console.error("Receive message from service worker failed!");
});
或者,脚本可以使用 onmessageerror 来监听消息反序列化错误。
js
// main.js
navigator.serviceWorker.onmessageerror = (event) => {
console.error("Receive message from service worker failed!");
};
规范
| 规范 |
|---|
| Service Workers # dom-serviceworkerglobalscope-onmessageerror |
浏览器兼容性
加载中…