MessagePort インターフェイスの close() メソッドは、ポートの接続を切断し、ポートがアクティブではなくなります。これは、そのポートへのメッセージの送信を停止します。
註: この機能は Web Workers 内で利用可能です。
構文
port.close()
戻り値
無効。
引数
なし。
例
次のコードブロックには、handleMessage ハンドラ関数があり、EventTarget.addEventListener を使用してこのドキュメントにメッセージが返された時に実行されます。
channel.port1.addEventListener('message',handleMessage,false);
function handleMessage(e) {
para.innerHTML = e.data;
textInput.value = '';
}
channel.port1.start();
次のようにして、いつでもメッセージの送信を停止できます。
channel.port1.close();
仕様
| 仕様書 | 策定状況 | 備考 |
|---|---|---|
| HTML Living Standard close() の定義 |
現行の標準 | Unknown との差異なし。 |
| Unknown close() の定義 |
不明 | 仕様の W3C バージョン。 |
ブラウザの実装状況
We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
| 機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| 基本サポート | 4 | 未サポート | 10.0 | 10.6 | 5 |
| Worker 内で利用可能 | (有) | 41 (41) | (有) | (有) | (有) |
| 機能 | Android | Chrome for Android | Firefox Mobile (Gecko) | Firefox OS (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|
| 基本サポート | 4.4 | 4 | 未サポート | 未サポート | 10.0 | 11.5 | 5.1 |
| Worker 内で利用可能 | (有) | (有) | 41.0 (41) | (有) | (有) | (有) | (有) |