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 貢獻者修改。