BroadcastChannel

Baseline 2022

Newly available

Since March 2022, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

BroadcastChannel インターフェイスは、特定のオリジン閲覧コンテキストが加入できる名前付きチャンネルを表します。これにより、同じオリジンの異なる文書間(異なるウィンドウ、タブ、フレーム、iframe)の通信を可能にします。 メッセージは、チャンネルに参加しているすべての BroadcastChannel オブジェクトで発生する message イベントを介して配信されます。

注: この機能は Web Worker 内で利用可能です。

EventTarget BroadcastChannel

コンストラクター

BroadcastChannel()

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

インスタンスプロパティ

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

BroadcastChannel.name 読取専用

チャンネルの名前を表す文字列を返します。

インスタンスメソッド

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

BroadcastChannel.postMessage()

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

BroadcastChannel.close()

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

イベント

message

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

messageerror

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

仕様書

Specification
HTML Standard
# broadcasting-to-other-browsing-contexts

ブラウザーの互換性

BCD tables only load in the browser

関連情報