WebSocket.close()

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.

La méthode WebSocket.close() ferme la connexion WebSocket ou interrompt l'éventuelle tentative de connexion. Si la connexion est déjà fermée (état CLOSED), cette méthode ne fait rien.

Syntaxe

js
WebSocket.close();
js
WebSocket.close(code);
js
WebSocket.close(reason);
js
WebSocket.close(code, reason);

Paramètres

code Facultatif

Une valeur numérique indiquant le code de statut qui explique pourquoi la connexion est fermée. Si ce paramètre n'est pas fourni, 1005 sera la valeur par défaut. Voir la liste des codes de statut de CloseEvent pour les valeurs autorisées.

reason Facultatif

Une chaîne de caractères, lisible et compréhensible par un humain qui explique pourquoi la connexion est fermée. Cette chaîne ne doit pas être plus longue que 123 octets de texte UTF-8 (attention, cela ne signifie pas 123 caractères).

Exceptions levées

INVALID_ACCESS_ERR

Un code invalide a été fourni avec code.

SYNTAX_ERR

La chaîne de caractères pour reason est trop longue ou contient des

surrogates

non appairés.

Note : Avant Gecko 8.0, cette méthode ne prenait en charge aucun paramètre.

Spécifications

Specification
WebSockets
# ref-for-dom-websocket-close①

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
close

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support