DOM

インターフェイス

WebSocket インターフェイス

→●、MS

WebSocket オブジェクトは、サーバーへの WebSocket 接続の作成と管理、および接続上のデータの送受信に使用する API を提供します。

WebSocket を構築するには、WebSocket() コンストラクターを使用してください。

コンストラクター

new WebSocket(url[, protocols]) ●

新しく作成された WebSocket オブジェクトを返します。

定数

プロパティ

WebSocket.binaryType ●

接続で使用されるバイナリデータ型。

WebSocket.bufferedAmount 読取専用 ●

キューに入れられたデータのバイト数。

WebSocket.extensions 読取専用 ●

サーバーによって選択された拡張機能。

WebSocket.protocol 読取専用 ●

サーバーによって選択されたサブ プロトコル。

WebSocket.readyState 読取専用 ●

接続の現在の状態。

WebSocket.url 読取専用 ●

WebSocket の絶対 URL。

メソッド

WebSocket.close([code[, reason]]) ●

接続を閉じます。

WebSocket.send(data) ●

送信するデータをキューに入れます。

イベントハンドラー

WebSocket.onclose

接続が閉じられたときに呼び出されるイベントリスナー。

WebSocket.onerror

エラーが発生したときに呼び出されるイベントリスナー。

WebSocket.onmessage

サーバーからメッセージを受信したときに呼び出されるイベントリスナー。

WebSocket.onopen

接続が開かれたときに呼び出されるイベントリスナー。

イベント

これらのイベントを待ち受けするには、addEventListener() を使用するか、イベントリスナーをこのインターフェイスの oneventname プロパティへ代入します。

close

WebSocket による接続が閉じたときに発生します。

onclose プロパティからも利用できます。

error

WebSocket による接続が、データの一部が送信できなかったなどのエラーのために閉じた時に発生します。

onerror プロパティからも利用できます。

message

WebSocket を通じてデータを受信したときに発生します。

onmessage プロパティからも利用できます。

open

WebSocket による接続が開いたときに発生します。

onopen プロパティからも利用できます。

例

// WebSocket 接続を作成
const socket = new WebSocket('ws://localhost:8080');

// 接続が開いたときのイベント
socket.addEventListener('open', function (event) {
    socket.send('Hello Server!');
});

// メッセージの待ち受け
socket.addEventListener('message', function (event) {
    console.log('Message from server ', event.data);
});

テスト