MessageEvent: MessageEvent() コンストラクター

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2016年8月.

MessageEvent() コンストラクターは新しい MessageEvent オブジェクトのインスタンスを作成します。

構文

js
new MessageEvent(type)
new MessageEvent(type, options)

type

文字列で、このイベントの名前を示します。大文字と小文字を区別し、ブラウザーは常に message を設定します。

Event() で定義されたプロパティに加え、以下のプロパティを持つことができるオブジェクトです。

MessageEvent に含めたいデータ。これは任意のデータ型であり、指定しない場合は既定で null になります。

文字列で、メッセージの発信元を表します。指定しなかった場合の既定値は空文字列 ("") です。

文字列で、このイベントの一意な ID を表します。指定しなかった場合の既定値は空文字列 ("") です。

メッセージの送信元を表す MessageEventSource （Window、MessagePort、ServiceWorker の何れかのオブジェクト）を指定します。設定されていない場合の既定値は null です。

MessagePort オブジェクトの配列で、メッセージが（チャンネルメッセージングや共有ワーカーにメッセージを送信する場合など、適切な場合に）送信されるチャンネルに関連するポートを表します。指定しない場合の既定値は空の配列 ([]) になります。

新しい MessageEvent オブジェクトです。

js
const myMessage = new MessageEvent("message", {
  data: "hello",
});

Specification

Enable JavaScript to view this browser compatibility table.

Was this page helpful to you?

Yes No

This page was last modified on 2023年9月20日 by MDN contributors.