MessagePort: close() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

メモ: この機能はウェブワーカー内で利用可能です。

close() は MessagePort インターフェイスのメソッドで、ポートの接続を切断し、ポートがアクティブではなくなります。これは、そのポートへのメッセージの送信を停止します。

構文

js
close()

返値

なし。

引数

なし (undefined)。

例

次のコードブロックには、handleMessage ハンドラー関数があり、EventTarget.addEventListener を使用してこの文書にメッセージが返された時に実行されます。

js
channel.port1.addEventListener("message", handleMessage, false);
function handleMessage(e) {
  para.innerHTML = e.data;
  textInput.value = "";
}

channel.port1.start();

次のようにして、いつでもメッセージの送信を停止できます。

js
channel.port1.close();

仕様書

Specification
HTML Standard
# dom-messageport-close-dev

ブラウザーの互換性

BCD tables only load in the browser

関連情報