Worker: messageerror イベント

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

メモ: この機能はウェブワーカー内で利用可能ですが、サービスワーカーでは使用できません。

messageerror イベントは、 Worker オブジェクトに、解読 (deserialize) できないメッセージを受け取ったときに発生します。

このイベントはキャンセル不可で、バブリングしません。

構文

このイベント名を 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 オブジェクトの配列で、メッセージが送信されるチャネルに関連するポートを表します（チャネルメッセージングや共有ワーカーにメッセージを送信する場合など、必要に応じて）。

例

ワーカーを作成し、 message および messageerror イベントを addEventListener() で待ち受けします。

// main.js

const worker = new Worker("static/scripts/worker.js");

worker.addEventListener("message", (event) => {
  console.error(`Received message from worker: ${event}`);
});

worker.addEventListener("messageerror", (event) => {
  console.error(`Error receiving message from worker: ${event}`);
});

同じですが、 onmessageerror イベントハンドラープロパティを使用した例です。

// main.js

const worker = new Worker("static/scripts/worker.js");

worker.onmessage = (event) => {
  console.error(`Received message from worker: ${event}`);
};

worker.onmessageerror = (event) => {
  console.error(`Error receiving message from worker: ${event}`);
};