DedicatedWorkerGlobalScope: messageerror 事件

Baseline 已广泛支持

此功能已成熟，并可在许多设备和浏览器版本上运行。自 2023 年 3 月以来，它已在各种浏览器中可用。

注意：此功能仅在专用 Web Worker 中可用。

当 DedicatedWorkerGlobalScope 对象收到一条无法反序列化的消息时，会触发 messageerror 事件。

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

语法

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

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

onmessageerror = (event) => { }

一个 MessageEvent。继承自 Event。

此接口还继承了其父级 Event 的属性。

MessageEvent.data 只读: 由消息发送者发送的数据。
MessageEvent.origin 只读: 一个字符串，表示消息发送者的源。
MessageEvent.lastEventId 只读: 一个字符串，表示事件的唯一 ID。
MessageEvent.source 只读: 一个 MessageEventSource（可以是 WindowProxy、MessagePort 或 ServiceWorker 对象），表示消息发送者。
MessageEvent.ports 只读: 一个 MessagePort 对象数组，表示消息发送通道（如果适用，例如在通道消息传递或向共享工作者发送消息时）关联的端口。

使用 addEventListener() 监听 messageerror 事件

// worker.js

self.addEventListener("messageerror", (event) => {
  self.postMessage("Error receiving message");
  console.error(event);
});

相同功能，但使用 onmessageerror 事件处理属性

// worker.js

self.onmessageerror = (event) => {
  self.postMessage("Error receiving message");
  console.error(event);
};

规范
HTML # event-messageerror
HTML # handler-messageeventtarget-onmessageerror

此页面最后修改于 2025年5月2日，由 MDN 贡献者修改。