WebSockets

CloseEvent() コンストラクターは新しい CloseEvent オブジェクトを生成します。

code は CloseEvent インターフェイスの読み取り専用プロパティで、サーバーが接続を閉じた理由を示す WebSocket 接続クローズコードを返します。

reason は CloseEvent インターフェイスの読み取り専用プロパティで、サーバーが接続を閉じる際に示した WebSocket 接続が閉じた理由を返します。つまり、閉じたことについての簡潔で人間が読める散文的な説明です。

wasClean は CloseEvent インターフェイスの読み取り専用プロパティで、接続がきれいに閉じられた場合は true を返します。

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

WebSocket.binaryType プロパティは、この WebSocke 接続によって受信されているバイナリーデータの型を制御します。

WebSocket.bufferedAmount は読み取り専用のプロパティで、 send() の呼び出しによってキューに入れられてはいますが、まだネットワークに送信されていないデータのバイト数を返します。この値は、一度キューに入れられたデータすべてが送信されると 0 にリセットされます。なお、接続が閉じられたときは、 0 にリセットされません。 send() を呼び出し続けると、この値は大きくなっていきます。

WebSocket.close() メソッドは、 WebSocket の接続、もしくは接続試行（存在した場合）を閉じます。接続がすでに CLOSED だった場合、このメソッドは何もしません。

close イベントは、 WebSocket の接続が閉じられたときに発生します。

error イベントは、 WebSocket の接続がエラーによって閉じられた（例えば一部のデータを送信できなかった）ときに発生します。

WebSocket.extensions は読み取り専用のプロパティで、サーバーによって選択された拡張機能を返します。現在は、空文字列か、接続によってネゴシエートされた拡張機能のリストのみを返します。

message イベントは、 WebSocket を通してデータを受け取ったときに発生します。

open イベントは、 WebSocket のコネクションが開かれたときに発生します。

WebSocket.protocol は読み取り専用のプロパティで、サーバーが選択したサブプロトコル名を返します。これは WebSocket オブジェクトが作成されるときに、引数の protocols で指定された文字列のいずれかになりますが、接続が確立されていない場合は、空文字列となります。

RFC 6455で規定されたプロトコルに対応しています

WebSocket.readyState は読み取り専用のプロパティで、 WebSocket の「現在」の接続状態を返します。

WebSocket.send() メソッドは、 WebSocket 接続を介してサーバーに送るために指定されたデータを、格納するために必要なバイト数だけ bufferedAmount の値を増加させながらキューに入れます。もしデータが送信できなかった場合（例えば、バッファリングが必要だが、バッファが一杯であるなどの理由で）、ソケットは自動的に閉じられます。 接続が CONNECTING 状態のときに send() を呼び出すと、ブラウザーは例外を発生させます。接続が CLOSING または CLOSED の状態のときに send() を呼び出すと、ブラウザーはデータを暗黙に破棄します。

WebSocket.url は読み取り専用のプロパティで、コンストラクターによって解決された WebSocket の絶対 URL を返します。

WebSocket() コンストラクターは、新しい WebSocket オブジェクトを返し、指定された WebSocket URL への接続を直ちに確立しようとします。

`url` パラメータでは、`https`、`http`、および相対URLが使用可能です

労働者で利用可能

`WebSocketError()` コンストラクタ

HTTPの「Sec-WebSocket-Accept」レスポンスヘッダーは、WebSocketの接続確立時のハンドシェイクにおいて、サーバーがWebSocket接続へのアップグレードを受け入れることを示すために使用されます。

HTTPの「Sec-WebSocket-Extensions」リクエストヘッダーおよびレスポンスヘッダーは、WebSocketの接続確立時のハンドシェイクにおいて、クライアントとサーバーが使用するプロトコル拡張機能をネゴシエートするために使用されます。

HTTPの「Sec-WebSocket-Key」リクエストヘッダーは、WebSocketの接続確立時のハンドシェイクで使用され、クライアント（ユーザーエージェント）が、HTTPクライアントをWebSocketクライアントにアップグレードすることを「本当に希望している」ことを確認できるようにするためのものです。

HTTPの「Sec-WebSocket-Protocol」リクエストヘッダーおよびレスポンスヘッダーは、WebSocketの接続確立時のハンドシェイクにおいて、通信に使用するサブプロトコルをネゴシエートするために使用されます。これには、SOAPやWAMPのような広く認知されたプロトコルや、クライアントとサーバーが互いに理解できるカスタムプロトコルが含まれます。

HTTPの「Sec-WebSocket-Version」リクエストヘッダーおよびレスポンスヘッダーは、WebSocketの接続確立時のハンドシェイクにおいて、クライアントがサポートするWebSocketプロトコルを示すために使用されます。また、サーバーがリクエストで指定されたバージョンをサポートしていない場合、サーバーがサポートするプロトコルのバージョンを示すためにも使用されます。