WebSocket.close()

Die Funktion WebSocket.close() beendet eine WebSocket Verbindung oder den Versuch eines Verbindungsaufbaus. Wenn diese schon geschlossen ist, passiert nichts weiter.

Syntax

WebSocket.close();

Parameter

code Optional
Ein numerisch Wert, der den Status angibt, warum die Verbindung geschlossen wird. Wird kein Wert spezifiziert, . Zur Referenz kann diese Liste mit Codes des CloseEvents für gültige Werte genommen werden.
reason Optional
Ein lesbarer Text, welcher erklärt, warum die Verbindung geschlossen wird. Dieser muss UTF-8 kodiert und darf nicht länger als 123 Bytes sein.

Fehler

INVALID_ACCESS_ERR
Ein ungültiger code wurde angegeben.
SYNTAX_ERR
Der reason Text ist zu lang oder enthält ungültige Zeichen.

Note: In Gecko unterstützte diese Funktion bis zu Version 8.0 (Firefox 8.0 / Thunderbird 8.0 / SeaMonkey 2.5) keine Parameter.

Spezifikationen

Spezifikation Status Kommentar
HTML Living Standard
The definition of 'WebSocket.close()' in that specification.
Living Standard Initial definition

Browser Kompatibilität

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung Internet
closeChrome Vollständige Unterstützung 4Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 8
Vollständige Unterstützung 8
Keine Unterstützung 4 — 8
Hinweise
Hinweise Parameters not supported, see bug 674716.
IE Vollständige Unterstützung 10Opera Vollständige Unterstützung 12.1Safari Vollständige Unterstützung 5WebView Android Vollständige Unterstützung ≤37Chrome Android Vollständige Unterstützung 18Firefox Android Vollständige Unterstützung 8
Vollständige Unterstützung 8
Keine Unterstützung 4 — 8
Hinweise
Hinweise Parameters not supported, see bug 674716.
Opera Android Vollständige Unterstützung 12.1Safari iOS Vollständige Unterstützung 4.2Samsung Internet Android Vollständige Unterstützung 1.0

Legende

Vollständige Unterstützung  
Vollständige Unterstützung
Siehe Implementierungshinweise.
Siehe Implementierungshinweise.