--- title: MessagePort.close() slug: Web/API/MessagePort/close tags: - API - Channel messaging - MessagePort - Method - Reference translation_of: Web/API/MessagePort/close ---
{{APIRef("HTML DOM")}}

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

{{AvailableInWorkers}}

構文

port.close()

戻り値

無効。

引数

なし。

次のコードブロックには、handleMessage ハンドラ関数があり、{{domxref("EventTarget.addEventListener")}} を使用してこのドキュメントにメッセージが返された時に実行されます。

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

channel.port1.start();

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

channel.port1.close();

仕様

仕様書 策定状況 備考
{{SpecName('HTML WHATWG', '#dom-messageport-close','close()')}} {{Spec2('HTML WHATWG')}} {{SpecName("HTML5 Web Messaging")}} との差異なし。
{{SpecName('HTML5 Web Messaging', '#dom-messageport-close','close()')}} {{Spec2('HTML5 Web Messaging')}} 仕様の W3C バージョン。

ブラウザの実装状況

{{CompatibilityTable}}
機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
基本サポート 4 {{CompatNo}} 10.0 10.6 5
Worker 内で利用可能 {{CompatVersionUnknown}} {{CompatGeckoDesktop(41)}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}}
機能 Android Chrome for Android Firefox Mobile (Gecko) Firefox OS (Gecko) IE Phone Opera Mobile Safari Mobile
基本サポート 4.4 4 {{CompatNo}} {{CompatNo}} 10.0 11.5 5.1
Worker 内で利用可能 {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatGeckoMobile(41)}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}}

関連情報