ServiceWorkerGlobalScope:messageerror 事件

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

注意:此功能仅在 Service Workers 中可用。

当无法反序列化传入消息时,ServiceWorkerGlobalScope 接口的 messageerror 事件会发生。

此事件不可取消,也不会冒泡。

语法

在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。

js
addEventListener("messageerror", (event) => { })

onmessageerror = (event) => { }

事件类型

一个 ExtendableMessageEvent。继承自 ExtendableEvent

Event ExtendableEvent ExtendableMessageEvent

事件属性

继承自其父级 ExtendableEvent 的属性.

ExtendableMessageEvent.data 只读

返回事件的数据。它可以是任何数据类型。如果分发在 messageerror 事件中,则该属性将为 null

ExtendableMessageEvent.origin 只读

返回发送消息的 Client 的来源。

ExtendableMessageEvent.lastEventId 只读

Server-Sent Events 中,表示事件源的最后一个事件 ID。

ExtendableMessageEvent.source 只读

返回发送消息的 Client 对象的引用。

ExtendableMessageEvent.ports 只读

返回包含代表关联消息通道的端口的 MessagePort 对象的数组。

示例

在下面的示例中,一个页面通过 ServiceWorkerRegistration.active 获取了 ServiceWorker 对象的句柄,然后调用了它的 postMessage() 函数。

js
// 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");
  });
}

Service Worker 可以通过监听 messageerror 事件来监听消息反序列化错误。

js
// service-worker.js
self.addEventListener("messageerror", (event) => {
  // event is an ExtendableMessageEvent object
  console.error("Message deserialization failed");
});

或者,脚本可以使用 onmessageerror 监听消息反序列化错误。

js
// service-worker.js
self.onmessageerror = (event) => {
  // event is an ExtendableMessageEvent object
  console.error("Message deserialization failed");
};

规范

规范
Service Workers
# eventdef-serviceworkerglobalscope-messageerror
Service Workers
# dom-serviceworkerglobalscope-onmessageerror

浏览器兼容性

另见