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

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2018年4月以降、すべてのブラウザーで利用可能です。

メモ: この機能はサービスワーカー内でのみ利用可能です。

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

構文

new ExtendableMessageEvent(type)
new ExtendableMessageEvent(type, options)

引数

type

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

options 省略可

ExtendableEvent() で定義されたプロパティに加えて、下記のプロパティを持つオブジェクトです。

data 省略可: イベントのデータです。これはどのデータ型でもかまいません。既定値は null です。
origin 省略可: 文字列で、対応するサービスワーカーの環境設定オブジェクトのオリジンを定義します。既定値は "" です。
lastEventId 省略可: 文字列で、イベントソースの最後のイベント ID を定義します。
source 省略可: メッセージを送信した Client、ServiceWorker、MessagePort のいずれかです。既定値は null です。
ports 省略可: メッセージを送信するチャネルに接続された MessagePort オブジェクトを含む配列です。既定値は空の配列です。

返値

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

例

const options = {
  data: "hello message",
  source: MessagePortReference,
  ports: MessagePortListReference,
};

const myEME = new ExtendableMessageEvent("message", init);