Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

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 ⁨juillet 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

Voir aussi