WebSocket()

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

構文

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

引数

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

投げられる例外

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

仕様書

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

ブラウザ互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
WebSocket() constructorChrome 完全対応 ありEdge 完全対応 ≤79Firefox 完全対応 7
完全対応 7
未対応 4 — 7
補足
補足 Parameter protocols not supported.
IE ? Opera 完全対応 ありSafari ? WebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 7Opera Android ? Safari iOS ? Samsung Internet Android 完全対応 あり

凡例

完全対応  
完全対応
実装状況不明  
実装状況不明
実装ノートを参照してください。
実装ノートを参照してください。