aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/websocket/close_event/index.md
blob: 694f9f6835be08098264c9ef6f63b415e3168584 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
---
title: 'WebSocket : évènement close'
slug: Web/API/WebSocket/close_event
translation_of: Web/API/WebSocket/close_event
browser-compat: api.WebSocket.close_event
---
{{APIRef}}

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

<table class="properties">
  <tbody>
    <tr>
      <th scope="row">Bouillonne/Remonte</th>
      <td>Non</td>
    </tr>
    <tr>
      <th scope="row">Annulable</th>
      <td>Non</td>
    </tr>
    <tr>
      <th scope="row">Interface</th>
      <td>
        <a href="/fr/docs/Web/API/CloseEvent"><code>CloseEvent</code></a>
      </td>
    </tr>
    <tr>
      <th scope="row">Propriété de gestionnaire d'évènement correspondante</th>
      <td>
        <a href="/fr/docs/Web/API/WebSocket/onclose"><code>onclose</code></a>
      </td>
    </tr>
  </tbody>
</table>

## 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

{{Specifications}}

## Compatibilité des navigateurs

{{Compat}}

## Voir aussi

- [WebSocket : évènement `error`](/fr/docs/Web/API/WebSocket/error_event)
- [WebSocket : évènement `message`](/fr/docs/Web/API/WebSocket/message_event)
- [WebSocket : évènement `open`](/fr/docs/Web/API/WebSocket/open_event)
- [Écrire des applications clientes WebSocket](/fr/docs/Web/API/WebSockets_API/Writing_WebSocket_client_applications)