CloseEvent

CloseEvent は、 WebSockets を使用して接続が閉じられたときにクライアントに送信されます。これは WebSocket オブジェクトの onclose 属性で指定されたリスナーに配信されます。

コンストラクター

CloseEvent() (en-US)
新しい CloseEvent を作成します。

プロパティ

このインタフェースは親である Event からプロパティを継承します。

CloseEvent.code 読取専用
サーバーが送信したクローズコードを含む unsigned short を返します。以下の値は許可されたステータスコードです。以下の定義は、 IANA のウェブサイト [Ref] から供給されています。 1xxx コードは WebSocket 内部のみであり、転送されたデータと同じ意味ではありません (アプリケーション層プロトコルが無効な場合など)。 Firefox で指定できるコードは 1000 と 3000〜4999 [Source, Bug] のみです。
ステータスコード 名前 説明
0999 予約済みで使用されていません。
1000 Normal Closure 通常のクロージャ。接続が作成された目的に関係なく、接続は正常に完了しました。
1001 Going Away エンドポイントは、サーバーに障害が発生したか、またはブラウザーが接続を作成したページから離れようとしているために接続を終了しています。
1002 Protocol Error エンドポイントがプロトコルエラーのために接続を終了しています。
1003 Unsupported Data エンドポイントが受け入れられないタイプのデータを受信したため (たとえば、テキストのみのエンドポイントがバイナリデータを受信したとき)、接続が終了しています。
1004 予約済。 意味は将来定義されるかもしれません。
1005 No Status Received 予約済。予想されたにもかかわらずステータスコードが提供されなかったことを示します。
1006 Abnormal Closure 予約済。ステータスコードが必要なときに、接続が異常終了した (つまり、クローズフレームが送信されていない) ことを示すために使用されます。
1007 Invalid frame payload data 矛盾したデータ (例えば、テキストメッセージ内の非 UTF-8 データ) を含むメッセージを受信したため、エンドポイントは接続を終了しています。
1008 Policy Violation エンドポイントはポリシーに違反するメッセージを受信したため、接続を終了しています。これは一般的なステータスコードであり、コード 1003 と 1009 が適切でない場合に使用されます。
1009 Message too big 大きすぎるデータフレームを受信したため、エンドポイントは接続を終了しています。
1010 Missing Extension クライアントは、サーバーが1つ以上の拡張をネゴシエートすることを期待していましたがサーバーはそれを行わなかったため、サーバーは接続を終了しています。
1011 Internal Error サーバーは、予期しない条件が発生し要求の実行を妨げたため、接続を終了しています。
1012 Service Restart サーバーが再起動しているため、接続を終了しています。[Ref]
1013 Try Again Later サーバは、一時的な条件のために接続を終了しています。それはオーバーロードされ、クライアントの一部をキャストしています。[Ref]
1014 Bad Gateway サーバーがゲートウェイまたはプロキシとして機能し、アップストリームサーバーから無効なレスポンスを受信しました。これは 502 HTTP ステータスコードに似ています。
1015 TLS Handshake 予約済。TLS ハンドシェイクの実行に失敗 (サーバー証明書を確認できないなど) したために接続が閉じられたことを示します。
10161999 将来の WebSocket 標準での使用のために予約されています。
20002999 WebSocket 拡張機能で使用するために予約されています。
30003999 ライブラリとフレームワークで使用できます。 アプリケーションによって使用されない可能性があります。先着順で IANA に登録できます。
40004999 アプリケーションで使用することができます。
CloseEvent.reason 読取専用
サーバーが接続を終了した理由を示す DOMString を返します。これは特定のサーバーとサブプロトコルに固有です。
CloseEvent.wasClean 読取専用
接続がきれいに閉じられたかどうかを示す Boolean を返します。

メソッド

このインターフェースは親である Event からメソッドを継承しています。

CloseEvent.initCloseEvent() (en-US) これは廃止された API であり、動作は保証されていません。
作成された CloseEvent の値を初期化します。イベントがすでにディスパッチされている場合、このメソッドは何も行いません。このメソッドをもう使用しないでください。代わりに、CloseEvent() (en-US) コンストラクタを使用してください。

仕様書

仕様書 状態 備考
HTML Living Standard
CloseEvent の定義
現行の標準 初回定義

ブラウザーの互換性

BCD tables only load in the browser

関連情報