From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/websocket/send/index.md | 81 ++++++++++++++++++-------------- 1 file changed, 45 insertions(+), 36 deletions(-) (limited to 'files/fr/web/api/websocket/send') diff --git a/files/fr/web/api/websocket/send/index.md b/files/fr/web/api/websocket/send/index.md index 62cd149882..866d01bcae 100644 --- a/files/fr/web/api/websocket/send/index.md +++ b/files/fr/web/api/websocket/send/index.md @@ -3,53 +3,62 @@ title: WebSocket.send() slug: Web/API/WebSocket/send browser-compat: api.WebSocket.send --- -

{{APIRef("Web Sockets API")}}

+{{APIRef("Web Sockets API")}} -

La méthode WebSocket.send() rajoute les données indiquées à la queue pour transmission au serveur via la connexion WebSocket, augmentant ainsi la valeur de bufferedAmount du nombre d'octets nécessaires pour les données. Si les données ne peuvent être envoyées (par exemple parce qu'elles doivent être mises en tampon mais que la mémoire tampon est pleine), la socket est fermée automatiquement.

+La méthode **`WebSocket.send()`** rajoute les données indiquées à la queue pour transmission au serveur via la connexion WebSocket, augmentant ainsi la valeur de `bufferedAmount` du nombre d'octets nécessaires pour les données. Si les données ne peuvent être envoyées (par exemple parce qu'elles doivent être mises en tampon mais que la mémoire tampon est pleine), la socket est fermée automatiquement. -

Syntaxe

+## Syntaxe -
+```js
 WebSocket.send("Coucou serveur !");
-
+``` -

Paramètres

+### Paramètres -
-
data
-
Les données à envoyer au serveur. La valeur peut avoir un des types suivants : -
-
USVString
-
Une chaîne de caractères. Cette chaîne est ajoutée au tampon au format UTF-8 et la valeur de bufferedAmount est augmentée du nombre d'octets nécessaires pour représenter cette chaîne de caractères UTF-8.
-
ArrayBuffer
-
Les données binaires peuvent aussi être envoyées avec un tableau typé. Son contenu binaire est mis en tampon et la valeur de bufferedAmount est augmentée du nombre d'octets nécessaires.
-
Blob
-
Lorsqu'une valeur Blob est fournie, les données brutes du blob sont rajoutées à la queue pour être transmises dans une frame binaire. La valeur de bufferedAmount est augmentée du nombre d'octets utilisés pour représenter ces données brutes.
-
ArrayBufferView
-
Il est possible d'envoyer n'importe quel objet étant un tableau typé JavaScript sous la forme d'une frame binaire. Le contenu des données binaires est rajouté à la queue dans le tampon et la valeur de bufferedAmount est augmentée du nombre d'octets correspondant.
-
-
-
+- `data` -

Exceptions levées

+ - : Les données à envoyer au serveur. La valeur peut avoir un des types suivants : -
-
INVALID_STATE_ERR
-
La connexion n'est pas ouverte actuellement.
-
SYNTAX_ERR
-
Les données sont une chaîne de caractères pour laquelle il existe des surrogates non appairés.
-
+ - [`USVString`](/fr/docs/Web/API/USVString) + - : Une chaîne de caractères. Cette chaîne est ajoutée au tampon au format UTF-8 et la valeur de `bufferedAmount` est augmentée du nombre d'octets nécessaires pour représenter cette chaîne de caractères UTF-8. + - [`ArrayBuffer`](/fr/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer) + - : Les données binaires peuvent aussi être envoyées avec un tableau typé. Son contenu binaire est mis en tampon et la valeur de `bufferedAmount` est augmentée du nombre d'octets nécessaires. + - [`Blob`](/fr/docs/Web/API/Blob) -
-

Note : Pour Gecko 6.0, l'implémentation de send() varie de la spécification : le moteur renvoie un booléen indiquant si la connexion est toujours ouverte (par extension, cela indique si les données ont été correctement rajoutées à la queue ou transmises). Ce comportement a été corrigé avec Gecko 8.0.

+ - : Lorsqu'une valeur `Blob` est fournie, les données brutes du blob sont rajoutées à la queue pour être transmises dans une -

Avec Gecko 11.0, la prise en charge des ArrayBuffer est implémentée mais pas celle pour les objets Blob.

-
+ frame -

Spécifications

+ binaire. La valeur de `bufferedAmount` est augmentée du nombre d'octets utilisés pour représenter ces données brutes. -

{{Specifications}}

+ - [`ArrayBufferView`](/fr/docs/Web/API/ArrayBufferView) -

Compatibilité des navigateurs

+ - : Il est possible d'envoyer n'importe quel objet étant [un tableau typé JavaScript](/fr/docs/Web/JavaScript/Typed_arrays) sous la forme d'une -

{{Compat}}

+ frame + + binaire. Le contenu des données binaires est rajouté à la queue dans le tampon et la valeur de `bufferedAmount` est augmentée du nombre d'octets correspondant. + +### Exceptions levées + +- `INVALID_STATE_ERR` + - : La connexion n'est pas ouverte actuellement. +- `SYNTAX_ERR` + + - : Les données sont une chaîne de caractères pour laquelle il existe des + + surrogates + + non appairés. + +> **Note :** Pour Gecko 6.0, l'implémentation de `send()` varie de la spécification : le moteur renvoie un booléen indiquant si la connexion est toujours ouverte (par extension, cela indique si les données ont été correctement rajoutées à la queue ou transmises). Ce comportement a été corrigé avec Gecko 8.0. +> +> Avec Gecko 11.0, la prise en charge des [`ArrayBuffer`](/fr/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer) est implémentée mais pas celle pour les objets [`Blob`](/fr/docs/Web/API/Blob). + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs + +{{Compat}} -- cgit v1.2.3-54-g00ecf