BroadcastChannel

BroadcastChannel インターフェイスは、特定のオリジンの閲覧コンテキストが購読できる名前付きチャネルを表します。 それは、同じオリジンの異なるドキュメント間（異なるウィンドウ、タブ、フレーム、iframe）の通信を可能にします。 メッセージは、チャンネルをリッスンしているすべての BroadcastChannel オブジェクトで発生する message イベントを介して放送されます。

コンストラクタ

BroadcastChannel()

名前付きチャンネルにリンクするオブジェクトを作成します。

プロパティ

このインターフェイスは、その親である EventTarget からもプロパティを継承します。

BroadcastChannel.name

チャネルの名前である DOMString を返します。

イベントハンドラ

BroadcastChannel.onmessage

このオブジェクトで message イベントが発生したときに実行する関数を指定する EventHandler プロパティ。

BroadcastChannel.onmessageerror

EventHandler は、MessageError 型の MessageEvent が発生したとき、つまり逆シリアル化できないメッセージを受け取ったときに呼び出されます。

メソッド

このインターフェイスは、その親である EventTarget からもメソッドを継承しています。

BroadcastChannel.postMessage()

同じチャンネルをリッスンしている各 BroadcastChannel オブジェクトに、任意の種類のオブジェクトのメッセージを送信します。

BroadcastChannel.close()

チャネルオブジェクトを閉じます。 これは、新しいメッセージを取得しないことを示し、最終的にガベージコレクションされることを許可します。

イベント

message

メッセージがチャネルに到着したときに発生します。
onmessage プロパティからも利用できます。

messageerror

逆シリアル化できないメッセージが到着したときに発生します。
onmessageerror プロパティからも利用できます。

仕様

ブラウザーの互換性

関連情報

• ブラウザコンテキスト間でやり取りするもう1つの、よりヘビー級の方法: ServiceWorker.
• Broadcast Channel API の概要