WebSocket()

WebSocket() コンストラクタは新しいWebSocket オブジェクトを返します。

構文

var aWebSocket = new WebSocket(url [, protocols]);

引数

url
接続先のURL。WebSocketサーバが応答するURLでなければならない。
protocols 省略可
プロトコル文字列ひとつもしくはその配列。サーバは複数のWebSocketサブプロトコルを実装することもでき、その文字列はサブプロトコルを指定するために使われる(例えば、一つのサーバが指定されたprotocolに応じて異なるタイプのやりとりを扱うようにしたい場合)。プロトコル文字列を指定しない場合は空文字列と見なされる。

投げられる例外

SECURITY_ERR
接続が試みられているポートがブロックされている場合
SyntaxError
URLが無効だった場合

仕様書

仕様書 状況 コメント
HTML Living Standard
the WebSocket constructor の定義
現行の標準

ブラウザ互換性

BCD tables only load in the browser