WebSocket : évènement 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.

L'évènement close est déclenché lorsqu'une connexion avec une WebSocket est fermée.

Bouillonne/Remonte Non
Annulable Non
Interface CloseEvent
Propriété de gestionnaire d'évènement correspondante onclose

Exemples

On peut vouloir savoir lorsque la connexion a été fermée afin de mettre à jour l'interface utilisateur ou, éventuellement, pour sauvegarder des données à propos de la connexion. Soit une variable socketExemple qui fait référence à une connexion WebSocket ouverte, le fragment de code suivant gère la situation où la socket a été fermée :

js
socketExemple.addEventListener("close", (event) => {
  console.log("La connexion a été fermée avec succès.");
});

On peut effectuer les mêmes actions avec la propriété de gestion d'évènement correspondante :

js
socketExemple.onclose = function (event) {
  console.log("La connexion a été fermée avec succès.");
};

Spécifications

Specification
WebSockets
# dom-websocket-onclose

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 event

Legend

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

Full support
Full support

Voir aussi