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 Standard
# dom-websocket-onclose

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi