CloseEvent: code-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die code-Eigenschaft der schreibgeschützten CloseEvent-Schnittstelle gibt einen WebSocket-Verbindungsschlusscode zurück, der den Grund für die Trennung der Verbindung angibt.

Wert

Ein ganzzahliger WebSocket-Verbindungsschlusscode im Bereich von 1000 bis 4999, der den Grund für die Trennung der Verbindung angibt.

Statuscode Bedeutung Beschreibung
0–999 Nicht verwendet.
1000 Normale Schließung Die Verbindung hat den Zweck, für den sie erstellt wurde, erfolgreich abgeschlossen.
1001 Geht weg Der Endpunkt ist nicht mehr vorhanden, entweder aufgrund eines Serverfehlers oder weil der Browser von der Seite weg navigiert, die die Verbindung geöffnet hat.
1002 Protokollfehler Der Endpunkt beendet die Verbindung aufgrund eines Protokollfehlers.
1003 Nicht unterstützte Daten Die Verbindung wird beendet, weil der Endpunkt Daten eines Typs erhalten hat, den er nicht akzeptieren kann (z. B. hat ein nur Text unterstützender Endpunkt Binärdaten erhalten).
1004 Reserviert Reserviert. Möglicherweise wird in Zukunft eine Bedeutung definiert.
1005 Kein Status empfangen Reserviert. Zeigt an, dass kein Statuscode bereitgestellt wurde, obwohl einer erwartet wurde.
1006 Abnormale Schließung Reserviert. Zeigt an, dass eine Verbindung abnormal geschlossen wurde (d.h., ohne dass ein Schluss-Frame gesendet wurde), wenn ein Statuscode erwartet wird.
1007 Ungültige Frame-Nutzdaten Der Endpunkt beendet die Verbindung, weil eine Nachricht empfangen wurde, die inkonsistente Daten enthielt (z.B. nicht UTF-8 Daten innerhalb einer Textnachricht).
1008 Politikverletzung Der Endpunkt beendet die Verbindung, weil er eine Nachricht erhalten hat, die seine Richtlinien verletzt. Dies ist ein generischer Statuscode, der verwendet wird, wenn die Codes 1003 und 1009 nicht geeignet sind.
1009 Nachricht zu groß Der Endpunkt beendet die Verbindung, weil ein Datenframe empfangen wurde, der zu groß ist.
1010 Obligatorische Erweiterung Der Client beendet die Verbindung, weil er erwartet hat, dass der Server eine oder mehrere Erweiterungen verhandelt, dies aber nicht getan hat.
1011 Interner Fehler Der Server beendet die Verbindung, weil er auf eine unerwartete Bedingung gestoßen ist, die ihn daran gehindert hat, die Anfrage zu erfüllen.
1012 Dienstneustart Der Server beendet die Verbindung, weil er neu gestartet wird.
1013 Versuchen Sie es später erneut Der Server beendet die Verbindung aufgrund einer temporären Bedingung, z.B. ist er überlastet und trennt einige seiner Clients.
1014 Schlechtes Gateway Der Server fungierte als Gateway oder Proxy und erhielt eine ungültige Antwort vom Upstream-Server. Dies ist ähnlich wie der HTTP-Statuscode 502.
1015 TLS-Handschlag Reserviert. Zeigt an, dass die Verbindung aufgrund eines Fehlers beim Durchführen eines TLS-Handshakes geschlossen wurde (z.B., das Serverzertifikat kann nicht verifiziert werden).
1016–2999 Zur Definition in zukünftigen Überarbeitungen der WebSocket-Protokollspezifikation und zur Definition durch Erweiterungsspezifikationen.
3000–3999 Zur Verwendung durch Bibliotheken, Frameworks und Anwendungen. Diese Statuscodes sind direkt bei der IANA registriert. Die Interpretation dieser Codes ist durch das WebSocket-Protokoll nicht definiert.
4000–4999 Für private Nutzung, und daher nicht registrierbar. Solche Codes können durch vorherige Vereinbarungen zwischen WebSocket-Anwendungen verwendet werden. Die Interpretation dieser Codes ist durch das WebSocket-Protokoll nicht definiert.

Beispiele

Das folgende Beispiel gibt den Wert von code in der Konsole aus.

js
WebSocket.onclose = (event) => {
  console.log(event.code);
};

Spezifikationen

Specification
WebSockets Standard
# ref-for-dom-closeevent-code②

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch