diff options
author | julieng <julien.gattelier@gmail.com> | 2021-10-02 17:20:24 +0200 |
---|---|---|
committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-10-02 17:30:20 +0200 |
commit | 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch) | |
tree | 30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/websocket | |
parent | c05efa8d7ae464235cf83d7c0956e42dc6974103 (diff) | |
download | translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2 translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip |
convert content to md
Diffstat (limited to 'files/fr/web/api/websocket')
18 files changed, 472 insertions, 447 deletions
diff --git a/files/fr/web/api/websocket/binarytype/index.md b/files/fr/web/api/websocket/binarytype/index.md index f9dc94bbb4..9cb18c285b 100644 --- a/files/fr/web/api/websocket/binarytype/index.md +++ b/files/fr/web/api/websocket/binarytype/index.md @@ -3,31 +3,28 @@ title: WebSocket.binaryType slug: Web/API/WebSocket/binaryType browser-compat: api.WebSocket.binaryType --- -<p>{{APIRef("Web Sockets API")}}</p> +{{APIRef("Web Sockets API")}} -<p>La propriété <strong><code>WebSocket.binaryType</code></strong> contrôle le type de données binaires reçues via la connexion WebSocket.</p> +La propriété **`WebSocket.binaryType`** contrôle le type de données binaires reçues via la connexion WebSocket. -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js var binaryType = aWebSocket.binaryType; -</pre> +``` -<h2 id="value">Valeur</h2> +## Valeur -<p>Une chaîne de caractères <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a> ayant l'une de ces deux valeurs :</p> +Une chaîne de caractères [`DOMString`](/fr/docs/Web/API/DOMString) ayant l'une de ces deux valeurs : -<dl> - <dt><code>"blob"</code></dt> - <dd>Utilise des objets <a href="/fr/docs/Web/API/Blob"><code>Blob</code></a> pour les données binaires. Il s'agit de la valeur par défaut.</dd> - <dt><code>"arraybuffer"</code></dt> - <dd>Utilise des objets <a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer"><code>ArrayBuffer</code></a> pour les données binaires. - </dd> -</dl> +- `"blob"` + - : Utilise des objets [`Blob`](/fr/docs/Web/API/Blob) pour les données binaires. Il s'agit de la valeur par défaut. +- `"arraybuffer"` + - : Utilise des objets [`ArrayBuffer`](/fr/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer) pour les données binaires. -<h2 id="examples">Exemples</h2> +## Exemples -<pre class="brush: js"> +```js // On crée une connexion WebSocket connection. const socket = new WebSocket("ws://localhost:8080"); // On change le type de données binaires de "blob" à "arraybuffer" @@ -43,12 +40,13 @@ socket.addEventListener("message", function (event) { // Frame textuelle console.log(event.data); } -});</pre> +}); +``` -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} diff --git a/files/fr/web/api/websocket/bufferedamount/index.md b/files/fr/web/api/websocket/bufferedamount/index.md index c4492c5c61..5edce55168 100644 --- a/files/fr/web/api/websocket/bufferedamount/index.md +++ b/files/fr/web/api/websocket/bufferedamount/index.md @@ -3,24 +3,24 @@ title: WebSocket.bufferedAmount slug: Web/API/WebSocket/bufferedAmount browser-compat: api.WebSocket.bufferedAmount --- -<p>{{APIRef("Web Sockets API")}}</p> +{{APIRef("Web Sockets API")}} -<p>La propriété en lecture seule <strong><code>WebSocket.bufferedAmount</code></strong> renvoie le nombre d'octets de données qui ont été placées dans la queue via des appels à <a href="/fr/docs/Web/API/WebSocket/send"><code>send()</code></a> mais qui n'ont pas encore été transmises sur le réseau. Cette valeur est réinitialisée à zéro lorsque toutes les données ont été envoyées. Cette valeur n'est pas remise à zéro lorsque la connexion est fermée. Des appels successifs à <a href="/fr/docs/Web/API/WebSocket/send"><code>send()</code></a> feront croître cette valeur.</p> +La propriété en lecture seule **`WebSocket.bufferedAmount`** renvoie le nombre d'octets de données qui ont été placées dans la queue via des appels à [`send()`](/fr/docs/Web/API/WebSocket/send) mais qui n'ont pas encore été transmises sur le réseau. Cette valeur est réinitialisée à zéro lorsque toutes les données ont été envoyées. Cette valeur n'est pas remise à zéro lorsque la connexion est fermée. Des appels successifs à [`send()`](/fr/docs/Web/API/WebSocket/send) feront croître cette valeur. -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js var bufferedAmount = aWebSocket.bufferedAmount; -</pre> +``` -<h2 id="value">Valeur</h2> +## Valeur -<p>Un nombre au format <code>unsigned long</code>.</p> +Un nombre au format `unsigned long`. -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} diff --git a/files/fr/web/api/websocket/close/index.md b/files/fr/web/api/websocket/close/index.md index 09621ca71b..2d916ec9a4 100644 --- a/files/fr/web/api/websocket/close/index.md +++ b/files/fr/web/api/websocket/close/index.md @@ -3,43 +3,53 @@ title: WebSocket.close() slug: Web/API/WebSocket/close browser-compat: api.WebSocket.close --- -<p>{{APIRef("Web Sockets API")}}</p> +{{APIRef("Web Sockets API")}} -<p>La méthode <strong><code>WebSocket.close()</code></strong> ferme la connexion <a href="/fr/docs/Web/API/WebSocket"><code>WebSocket</code></a> ou interrompt l'éventuelle tentative de connexion. Si la connexion est déjà fermée (état <code>CLOSED</code>), cette méthode ne fait rien.</p> +La méthode **`WebSocket.close()`** ferme la connexion [`WebSocket`](/fr/docs/Web/API/WebSocket) ou interrompt l'éventuelle tentative de connexion. Si la connexion est déjà fermée (état `CLOSED`), cette méthode ne fait rien. -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">WebSocket.close();</pre> -<pre class="brush: js">WebSocket.close(code);</pre> -<pre class="brush: js">WebSocket.close(reason);</pre> -<pre class="brush: js">WebSocket.close(code, reason);</pre> +```js +WebSocket.close(); +``` -<h3 id="parameters">Paramètres</h3> +```js +WebSocket.close(code); +``` -<dl> - <dt><code>code</code> {{optional_inline}}</dt> - <dd>Une valeur numérique indiquant le code de statut qui explique pourquoi la connexion est fermée. Si ce paramètre n'est pas fourni, 1005 sera la valeur par défaut. Voir <a href="/fr/docs/Web/API/CloseEvent#status_codes">la liste des codes de statut</a> de <a href="/fr/docs/Web/API/CloseEvent"><code>CloseEvent</code></a> pour les valeurs autorisées.</dd> - <dt><code>reason</code> {{optional_inline}}</dt> - <dd>Une chaîne de caractères, lisible et compréhensible par un humain qui explique pourquoi la connexion est fermée. Cette chaîne ne doit pas être plus longue que 123 octets de texte UTF-8 (attention, <strong>cela ne signifie pas</strong> 123 caractères).</dd> -</dl> +```js +WebSocket.close(reason); +``` -<h3 id="exceptions_thrown">Exceptions levées</h3> +```js +WebSocket.close(code, reason); +``` -<dl> - <dt><code>INVALID_ACCESS_ERR</code></dt> - <dd>Un code invalide a été fourni avec <code>code</code>.</dd> - <dt><code>SYNTAX_ERR</code></dt> - <dd>La chaîne de caractères pour <code>reason</code> est trop longue ou contient des <i lang="en">surrogates</i> non appairés.</dd> -</dl> +### Paramètres -<div class="note"> - <p><strong>Note :</strong> Avant Gecko 8.0, cette méthode ne prenait en charge aucun paramètre.</p> -</div> +- `code` {{optional_inline}} + - : Une valeur numérique indiquant le code de statut qui explique pourquoi la connexion est fermée. Si ce paramètre n'est pas fourni, 1005 sera la valeur par défaut. Voir [la liste des codes de statut](/fr/docs/Web/API/CloseEvent#status_codes) de [`CloseEvent`](/fr/docs/Web/API/CloseEvent) pour les valeurs autorisées. +- `reason` {{optional_inline}} + - : Une chaîne de caractères, lisible et compréhensible par un humain qui explique pourquoi la connexion est fermée. Cette chaîne ne doit pas être plus longue que 123 octets de texte UTF-8 (attention, **cela ne signifie pas** 123 caractères). -<h2 id="specifications">Spécifications</h2> +### Exceptions levées -<p>{{Specifications}}</p> +- `INVALID_ACCESS_ERR` + - : Un code invalide a été fourni avec `code`. +- `SYNTAX_ERR` -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> + - : La chaîne de caractères pour `reason` est trop longue ou contient des -<p>{{Compat}}</p> + <i lang="en">surrogates</i> + + non appairés. + +> **Note :** Avant Gecko 8.0, cette méthode ne prenait en charge aucun paramètre. + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs + +{{Compat}} diff --git a/files/fr/web/api/websocket/close_event/index.md b/files/fr/web/api/websocket/close_event/index.md index e09d0bb1db..694f9f6835 100644 --- a/files/fr/web/api/websocket/close_event/index.md +++ b/files/fr/web/api/websocket/close_event/index.md @@ -1,61 +1,67 @@ --- title: 'WebSocket : évènement close' slug: Web/API/WebSocket/close_event -browser-compat: api.WebSocket.close_event translation_of: Web/API/WebSocket/close_event +browser-compat: api.WebSocket.close_event --- -<div>{{APIRef}}</div> +{{APIRef}} -<p>L'évènement <code>close</code> est déclenché lorsqu'une connexion avec une <code>WebSocket</code> est fermée.</p> +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> + <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> -<h2 id="examples">Exemples</h2> +## Exemples -<p>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 <code>socketExemple</code> 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 :</p> +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 : -<pre class="brush: js">socketExemple.addEventListener('close', (event) => { +```js +socketExemple.addEventListener('close', (event) => { console.log('La connexion a été fermée avec succès.'); -});</pre> +}); +``` -<p>On peut effectuer les mêmes actions avec la propriété de gestion d'évènement correspondante :</p> +On peut effectuer les mêmes actions avec la propriété de gestion d'évènement correspondante : -<pre class="brush: js">socketExemple.onclose = function (event) { +```js +socketExemple.onclose = function (event) { console.log('La connexion a été fermée avec succès.'); -};</pre> +}; +``` -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} -<h2 id="Voir aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/API/WebSocket/error_event">WebSocket : évènement <code>error</code></a></li> - <li><a href="/fr/docs/Web/API/WebSocket/message_event">WebSocket : évènement <code>message</code></a></li> - <li><a href="/fr/docs/Web/API/WebSocket/open_event">WebSocket : évènement <code>open</code></a></li> - <li><a href="/fr/docs/Web/API/WebSockets_API/Writing_WebSocket_client_applications">Écrire des applications clientes WebSocket</a></li> -</ul> +- [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) diff --git a/files/fr/web/api/websocket/error_event/index.md b/files/fr/web/api/websocket/error_event/index.md index 91bb314dde..15f3cc9711 100644 --- a/files/fr/web/api/websocket/error_event/index.md +++ b/files/fr/web/api/websocket/error_event/index.md @@ -3,55 +3,58 @@ title: 'WebSocket : évènement error' slug: Web/API/WebSocket/error_event browser-compat: api.WebSocket.error_event --- -<div>{{APIRef}}</div> +{{APIRef}} -<p>L'évènement <code>error</code> est déclenché lorsqu'une connexion avec une <code>WebSocket</code> a été fermée à cause d'une erreur (par exemple lorsque des données n'ont pu être envoyées).</p> +L'évènement `error` est déclenché lorsqu'une connexion avec une `WebSocket` a été fermée à cause d'une erreur (par exemple lorsque des données n'ont pu être envoyées). <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/Event"><code>Event</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/onerror"><code>onerror</code></a></td> - </tr> - </tbody> + <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/Event"><code>Event</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/onerror"><code>onerror</code></a> + </td> + </tr> + </tbody> </table> -<h2 id="examples">Exemples</h2> +## Exemples -<pre class="brush: js"> +```js // On crée une connexion WebSocket const socket = new WebSocket('ws://localhost:8080'); // On écoute les éventuelles erreurs socket.addEventListener('error', function (event) { console.log('Erreur WebSocket : ', event); -});</pre> +}); +``` -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} -<h2 id="see_also">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/API/WebSocket/close_event">WebSocket : évènement <code>close</code></a></li> - <li><a href="/fr/docs/Web/API/WebSocket/message_event">WebSocket : évènement <code>message</code></a></li> - <li><a href="/fr/docs/Web/API/WebSocket/open_event">WebSocket : évènement <code>open</code></a></li> - <li><a href="/fr/docs/Web/API/WebSockets_API/Writing_WebSocket_client_applications">Écrire des applications clientes WebSocket</a></li> -</ul> +- [WebSocket : évènement `close`](/fr/docs/Web/API/WebSocket/close_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) diff --git a/files/fr/web/api/websocket/extensions/index.md b/files/fr/web/api/websocket/extensions/index.md index 5846b29953..ba88e1fad0 100644 --- a/files/fr/web/api/websocket/extensions/index.md +++ b/files/fr/web/api/websocket/extensions/index.md @@ -3,24 +3,24 @@ title: WebSocket.extensions slug: Web/API/WebSocket/extensions browser-compat: api.WebSocket.extensions --- -<p>{{APIRef("Web Sockets API")}}</p> +{{APIRef("Web Sockets API")}} -<p>La propriété en lecture seule <strong><code>WebSocket.extensions</code></strong> renvoie les extensions sélectionnées par le serveur. Actuellement, cette propriété vaut une chaîne de caractères vide ou la liste des extensions négociées par la connexion.</p> +La propriété en lecture seule **`WebSocket.extensions`** renvoie les extensions sélectionnées par le serveur. Actuellement, cette propriété vaut une chaîne de caractères vide ou la liste des extensions négociées par la connexion. -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js var extensions = aWebSocket.extensions; -</pre> +``` -<h2 id="value">Valeur</h2> +## Valeur -<p>Une chaîne de caractères <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a>.</p> +Une chaîne de caractères [`DOMString`](/fr/docs/Web/API/DOMString). -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} diff --git a/files/fr/web/api/websocket/index.md b/files/fr/web/api/websocket/index.md index 2ae740ebe7..83069c9f6d 100644 --- a/files/fr/web/api/websocket/index.md +++ b/files/fr/web/api/websocket/index.md @@ -1,102 +1,94 @@ --- title: WebSocket slug: Web/API/WebSocket -browser-compat: api.WebSocket translation_of: Web/API/WebSocket +browser-compat: api.WebSocket --- -<div>{{APIRef("Web Sockets API")}}</div> +{{APIRef("Web Sockets API")}} -<p>L'objet <code>WebSocket</code> fournit l'API qui permet de créer et de gérer une connexion <a href="/fr/docs/Web/API/WebSockets_API">WebSocket</a> à un serveur ainsi que d'envoyer et de recevoir des données sur cette connexion.</p> +L'objet `WebSocket` fournit l'API qui permet de créer et de gérer une connexion [WebSocket](/fr/docs/Web/API/WebSockets_API) à un serveur ainsi que d'envoyer et de recevoir des données sur cette connexion. -<p>Pour construire un objet <code>WebSocket</code>, on utilisera le constructeur <code><a href="/fr/docs/Web/API/WebSocket/WebSocket">WebSocket()</a></code>.</p> +Pour construire un objet `WebSocket`, on utilisera le constructeur [`WebSocket()`](/fr/docs/Web/API/WebSocket/WebSocket). -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="constructor">Constructeur</h2> +## Constructeur -<dl> - <dt><a href="/fr/docs/Web/API/WebSocket/WebSocket"><code>WebSocket(url[, protocols])</code></a></dt> - <dd>Renvoie un nouvel objet <code>WebSocket</code>.</dd> -</dl> +- [`WebSocket(url[, protocols])`](/fr/docs/Web/API/WebSocket/WebSocket) + - : Renvoie un nouvel objet `WebSocket`. -<h2 id="constants">Constantes</h2> +## Constantes <table class="standard-table"> - <tbody> - <tr> - <td class="header">Constante</td> - <td class="header">Valeur</td> - </tr> - <tr> - <td><code>WebSocket.CONNECTING</code></td> - <td><code>0</code></td> - </tr> - <tr> - <td><code>WebSocket.OPEN</code></td> - <td><code>1</code></td> - </tr> - <tr> - <td><code>WebSocket.CLOSING</code></td> - <td><code>2</code></td> - </tr> - <tr> - <td><code>WebSocket.CLOSED</code></td> - <td><code>3</code></td> - </tr> - </tbody> + <tbody> + <tr> + <td class="header">Constante</td> + <td class="header">Valeur</td> + </tr> + <tr> + <td><code>WebSocket.CONNECTING</code></td> + <td><code>0</code></td> + </tr> + <tr> + <td><code>WebSocket.OPEN</code></td> + <td><code>1</code></td> + </tr> + <tr> + <td><code>WebSocket.CLOSING</code></td> + <td><code>2</code></td> + </tr> + <tr> + <td><code>WebSocket.CLOSED</code></td> + <td><code>3</code></td> + </tr> + </tbody> </table> -<h2 id="properties">Propriétés</h2> - -<dl> - <dt><a href="/fr/docs/Web/API/WebSocket/binaryType"><code>WebSocket.binaryType</code></a></dt> - <dd>Le type de données binaire utilisé par la connexion.</dd> - <dt><a href="/fr/docs/Web/API/WebSocket/bufferedAmount"><code>WebSocket.bufferedAmount</code></a> {{readonlyinline}}</dt> - <dd>Le nombre d'octets de données dans la queue.</dd> - <dt><a href="/fr/docs/Web/API/WebSocket/extensions"><code>WebSocket.extensions</code></a> {{readonlyinline}}</dt> - <dd>Les extensions sélectionnées par le serveur.</dd> - <dt><a href="/fr/docs/Web/API/WebSocket/onclose"><code>WebSocket.onclose</code></a></dt> - <dd>Un gestionnaire d'évènement à appeler lorsque la connexion est fermée.</dd> - <dt><a href="/fr/docs/Web/API/WebSocket/onerror"><code>WebSocket.onerror</code></a></dt> - <dd>Un gestionnaire d'évènement à appeler en cas d'erreur.</dd> - <dt><a href="/fr/docs/Web/API/WebSocket/onmessage"><code>WebSocket.onmessage</code></a></dt> - <dd>Un gestionnaire d'évènement à appeler lors de la réception d'un message du serveur.</dd> - <dt><a href="/fr/docs/Web/API/WebSocket/onopen"><code>WebSocket.onopen</code></a></dt> - <dd>Un gestionnaire d'évènement à appeler lorsque la connexion est ouverte.</dd> - <dt><a href="/fr/docs/Web/API/WebSocket/protocol"><code>WebSocket.protocol</code></a> {{readonlyinline}}</dt> - <dd>Le sous-protocole sélectionné par le serveur.</dd> - <dt><a href="/fr/docs/Web/API/WebSocket/readyState"><code>WebSocket.readyState</code></a> {{readonlyinline}}</dt> - <dd>L'état courant de la connexion.</dd> - <dt><a href="/fr/docs/Web/API/WebSocket/url"><code>WebSocket.url</code></a> {{readonlyinline}}</dt> - <dd>L'URL absolue de la WebSocket.</dd> -</dl> - -<h2 id="methods">Méthodes</h2> - -<dl> - <dt><a href="/fr/docs/Web/API/WebSocket/close"><code>WebSocket.close([code[, reason]])</code></a></dt> - <dd>Ferme la connexion.</dd> - <dt><a href="/fr/docs/Web/API/WebSocket/send"><code>WebSocket.send(data)</code></a></dt> - <dd>Ajoute des données à transmettre à la queue.</dd> -</dl> - -<h2 id="events">Évènements</h2> - - -<dl> - <dt><a href="/fr/docs/Web/API/WebSocket/close_event"><code>close</code></a></dt> - <dd>Déclenché lorsqu'une connexion avec une <code>WebSocket</code> est fermée. Également disponible avec la propriété <a href="/fr/docs/Web/API/WebSocket/onclose"><code>onclose</code></a>.</dd> - <dt><a href="/fr/docs/Web/API/WebSocket/error_event"><code>error</code></a></dt> - <dd>Déclenché lorsqu'une connexion avec une <code>WebSocket</code> a été fermée à cause d'une erreur, par exemple lorsque des données n'ont pu être envoyées. Également disponible avec la propriété <a href="/fr/docs/Web/API/WebSocket/onerror"><code>onerror</code></a>.</dd> - <dt><a href="/fr/docs/Web/API/WebSocket/message_event"><code>message</code></a></dt> - <dd>Déclenché lorsque des données sont reçues via une <code>WebSocket</code>. Également disponible avec la propriété <a href="/fr/docs/Web/API/WebSocket/onmessage"><code>onmessage</code></a>.</dd> - <dt><a href="/fr/docs/Web/API/WebSocket/open_event"><code>open</code></a></dt> - <dd>Déclenché lorsqu'une connexion avec une <code>WebSocket</code> est ouverte. Également disponible avec la propriété <a href="/fr/docs/Web/API/WebSocket/onopen"><code>onopen</code></a>.</dd> -</dl> - -<h2 id="examples">Exemples</h2> - -<pre class="brush: js">// Créer une connexion WebSocket +## Propriétés + +- [`WebSocket.binaryType`](/fr/docs/Web/API/WebSocket/binaryType) + - : Le type de données binaire utilisé par la connexion. +- [`WebSocket.bufferedAmount`](/fr/docs/Web/API/WebSocket/bufferedAmount) {{readonlyinline}} + - : Le nombre d'octets de données dans la queue. +- [`WebSocket.extensions`](/fr/docs/Web/API/WebSocket/extensions) {{readonlyinline}} + - : Les extensions sélectionnées par le serveur. +- [`WebSocket.onclose`](/fr/docs/Web/API/WebSocket/onclose) + - : Un gestionnaire d'évènement à appeler lorsque la connexion est fermée. +- [`WebSocket.onerror`](/fr/docs/Web/API/WebSocket/onerror) + - : Un gestionnaire d'évènement à appeler en cas d'erreur. +- [`WebSocket.onmessage`](/fr/docs/Web/API/WebSocket/onmessage) + - : Un gestionnaire d'évènement à appeler lors de la réception d'un message du serveur. +- [`WebSocket.onopen`](/fr/docs/Web/API/WebSocket/onopen) + - : Un gestionnaire d'évènement à appeler lorsque la connexion est ouverte. +- [`WebSocket.protocol`](/fr/docs/Web/API/WebSocket/protocol) {{readonlyinline}} + - : Le sous-protocole sélectionné par le serveur. +- [`WebSocket.readyState`](/fr/docs/Web/API/WebSocket/readyState) {{readonlyinline}} + - : L'état courant de la connexion. +- [`WebSocket.url`](/fr/docs/Web/API/WebSocket/url) {{readonlyinline}} + - : L'URL absolue de la WebSocket. + +## Méthodes + +- [`WebSocket.close([code[, reason]])`](/fr/docs/Web/API/WebSocket/close) + - : Ferme la connexion. +- [`WebSocket.send(data)`](/fr/docs/Web/API/WebSocket/send) + - : Ajoute des données à transmettre à la queue. + +## Évènements + +- [`close`](/fr/docs/Web/API/WebSocket/close_event) + - : Déclenché lorsqu'une connexion avec une `WebSocket` est fermée. Également disponible avec la propriété [`onclose`](/fr/docs/Web/API/WebSocket/onclose). +- [`error`](/fr/docs/Web/API/WebSocket/error_event) + - : Déclenché lorsqu'une connexion avec une `WebSocket` a été fermée à cause d'une erreur, par exemple lorsque des données n'ont pu être envoyées. Également disponible avec la propriété [`onerror`](/fr/docs/Web/API/WebSocket/onerror). +- [`message`](/fr/docs/Web/API/WebSocket/message_event) + - : Déclenché lorsque des données sont reçues via une `WebSocket`. Également disponible avec la propriété [`onmessage`](/fr/docs/Web/API/WebSocket/onmessage). +- [`open`](/fr/docs/Web/API/WebSocket/open_event) + - : Déclenché lorsqu'une connexion avec une `WebSocket` est ouverte. Également disponible avec la propriété [`onopen`](/fr/docs/Web/API/WebSocket/onopen). + +## Exemples + +```js +// Créer une connexion WebSocket const socket = new WebSocket('ws://localhost:8080'); // La connexion est ouverte @@ -107,18 +99,17 @@ socket.addEventListener('open', function (event) { // Écouter les messages socket.addEventListener('message', function (event) { console.log('Voici un message du serveur', event.data); -});</pre> +}); +``` -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} -<h2 id="see_also">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/API/WebSockets_API/Writing_WebSocket_client_applications">Écrire des applications clientes WebSocket</a></li> -</ul> +- [Écrire des applications clientes WebSocket](/fr/docs/Web/API/WebSockets_API/Writing_WebSocket_client_applications) diff --git a/files/fr/web/api/websocket/message_event/index.md b/files/fr/web/api/websocket/message_event/index.md index dc35ad18b2..aa1fb404e9 100644 --- a/files/fr/web/api/websocket/message_event/index.md +++ b/files/fr/web/api/websocket/message_event/index.md @@ -3,55 +3,60 @@ title: 'WebSocket : évènement message' slug: Web/API/WebSocket/message_event browser-compat: api.WebSocket.message_event --- -<div>{{APIRef}}</div> +{{APIRef}} -<p>L'évènement <code>message</code> est déclenché lorsque des données sont reçues via une <code>WebSocket</code>.</p> +L'évènement `message` est déclenché lorsque des données sont reçues via une `WebSocket`. <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/MessageEvent"><code>MessageEvent</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/onmessage"><code>onmessage</code></a></td> - </tr> - </tbody> + <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/MessageEvent"><code>MessageEvent</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/onmessage" + ><code>onmessage</code></a + > + </td> + </tr> + </tbody> </table> -<h2 id="examples">Exemples</h2> +## Exemples -<pre class="brush: js"> +```js // Crée une connexion WebSocket const socket = new WebSocket('ws://localhost:8080'); // Écoute les différents messages socket.addEventListener('message', function (event) { console.log('Message reçu du serveur ', event.data); -});</pre> +}); +``` -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} -<h2 id="see_also">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/API/WebSocket/close_event">WebSocket : évènement <code>close</code></a></li> - <li><a href="/fr/docs/Web/API/WebSocket/error_event">WebSocket : évènement <code>error</code></a></li> - <li><a href="/fr/docs/Web/API/WebSocket/open_event">WebSocket : évènement <code>open</code></a></li> - <li><a href="/fr/docs/Web/API/WebSockets_API/Writing_WebSocket_client_applications">Écrire des applications clientes WebSocket</a></li> - </ul> +- [WebSocket : évènement `close`](/fr/docs/Web/API/WebSocket/close_event) +- [WebSocket : évènement `error`](/fr/docs/Web/API/WebSocket/error_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) diff --git a/files/fr/web/api/websocket/onclose/index.md b/files/fr/web/api/websocket/onclose/index.md index 040f03c485..6fa1d347a2 100644 --- a/files/fr/web/api/websocket/onclose/index.md +++ b/files/fr/web/api/websocket/onclose/index.md @@ -3,25 +3,26 @@ title: WebSocket.onclose slug: Web/API/WebSocket/onclose browser-compat: api.WebSocket.onclose --- -<p>{{APIRef("Web Sockets API")}}</p> +{{APIRef("Web Sockets API")}} -<p>La propriété <code><strong>WebSocket.onclose</strong></code> est un <a href="/fr/docs/Web/Events/Event_handlers">gestionnaire d'évènement</a> invoqué lorsque l'état <a href="/fr/docs/Web/API/WebSocket/readyState"><code>readyState</code></a> de la connexion WebSocket change de valeur pour passer à <a href="/fr/docs/Web/API/WebSocket/readyState"><code>CLOSED</code></a>. Ce gestionnaire est appelé avec un paramètre <a href="/fr/docs/Web/API/CloseEvent"><code>CloseEvent</code></a>.</p> +La propriété **`WebSocket.onclose`** est un [gestionnaire d'évènement](/fr/docs/Web/Events/Event_handlers) invoqué lorsque l'état [`readyState`](/fr/docs/Web/API/WebSocket/readyState) de la connexion WebSocket change de valeur pour passer à [`CLOSED`](/fr/docs/Web/API/WebSocket/readyState). Ce gestionnaire est appelé avec un paramètre [`CloseEvent`](/fr/docs/Web/API/CloseEvent). -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js unWebSocket.onclose = function(event) { console.log("La WebSocket est désormais fermée."); -};</pre> +}; +``` -<h2 id="value">Valeur</h2> +## Valeur -<p>Une fonction <a href="/fr/docs/Web/API/EventListener"><code>EventListener</code></a>.</p> +Une fonction [`EventListener`](/fr/docs/Web/API/EventListener). -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} diff --git a/files/fr/web/api/websocket/onerror/index.md b/files/fr/web/api/websocket/onerror/index.md index 5ffafd26cd..d533a031db 100644 --- a/files/fr/web/api/websocket/onerror/index.md +++ b/files/fr/web/api/websocket/onerror/index.md @@ -3,33 +3,34 @@ title: WebSocket.onerror slug: Web/API/WebSocket/onerror browser-compat: api.WebSocket.onerror --- -<div>{{APIRef("Web Sockets API")}}</div> +{{APIRef("Web Sockets API")}} -<p>La propriété <code><strong>onerror</strong></code> de l'interface <a href="/fr/docs/Web/API/WebSocket"><code>WebSocket</code></a> est un gestionnaire d'évènement qui est appelé lorsqu'une erreur se produit sur la connexion WebSocket.</p> +La propriété **`onerror`** de l'interface [`WebSocket`](/fr/docs/Web/API/WebSocket) est un gestionnaire d'évènement qui est appelé lorsqu'une erreur se produit sur la connexion WebSocket. -<p>Il est également possible d'ajouter un gestionnaire d'évènement <code>error</code> avec la méthode <a href="/fr/docs/Web/API/EventTarget/addEventListener"><code>addEventListener()</code></a>.</p> +Il est également possible d'ajouter un gestionnaire d'évènement `error` avec la méthode [`addEventListener()`](/fr/docs/Web/API/EventTarget/addEventListener). -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js webSocket.onerror = eventHandler; -</pre> +``` -<h3 id="value">Valeur</h3> +### Valeur -<p>Une fonction ou un <a href="/fr/docs/Web/Events/Event_handlers">gestionnaire d'évènement</a> qui est exécuté lorsqu'un évènement <code>error</code> se produit sur la connexion WebSocket.</p> +Une fonction ou un [gestionnaire d'évènement](/fr/docs/Web/Events/Event_handlers) qui est exécuté lorsqu'un évènement `error` se produit sur la connexion WebSocket. -<h2 id="example">Exemple</h2> +## Exemple -<pre class="brush: js"> +```js webSocket.onerror = function(event) { console.error("Erreur WebSocket observée :", event); -};</pre> +}; +``` -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} diff --git a/files/fr/web/api/websocket/onmessage/index.md b/files/fr/web/api/websocket/onmessage/index.md index 03ff9451fb..aa71dcccbf 100644 --- a/files/fr/web/api/websocket/onmessage/index.md +++ b/files/fr/web/api/websocket/onmessage/index.md @@ -3,25 +3,26 @@ title: WebSocket.onmessage slug: Web/API/WebSocket/onmessage browser-compat: api.WebSocket.onmessage --- -<div>{{APIRef("Web Sockets API")}}</div> +{{APIRef("Web Sockets API")}} -<p>La propriété <strong><code>WebSocket.onmessage</code></strong> est un <a href="/fr/docs/Web/Events/Event_handlers">gestionnaire d'évènement</a> qui est appelé lorsqu'un message est reçu depuis le serveur. Ce gestionnaire est appelé avec un évènement <a href="/fr/docs/Web/API/MessageEvent"><code>MessageEvent</code></a> en paramètre.</p> +La propriété **`WebSocket.onmessage`** est un [gestionnaire d'évènement](/fr/docs/Web/Events/Event_handlers) qui est appelé lorsqu'un message est reçu depuis le serveur. Ce gestionnaire est appelé avec un évènement [`MessageEvent`](/fr/docs/Web/API/MessageEvent) en paramètre. -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js unWebSocket.onmessage = function(event) { console.debug("Message WebSocket reçu :", event); -};</pre> +}; +``` -<h2 id="value">Valeur</h2> +## Valeur -<p>Un objet <a href="/fr/docs/Web/API/EventListener"><code>EventListener</code></a>.</p> +Un objet [`EventListener`](/fr/docs/Web/API/EventListener). -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} diff --git a/files/fr/web/api/websocket/onopen/index.md b/files/fr/web/api/websocket/onopen/index.md index 488b3eb0be..90acf4f1f1 100644 --- a/files/fr/web/api/websocket/onopen/index.md +++ b/files/fr/web/api/websocket/onopen/index.md @@ -3,25 +3,26 @@ title: WebSocket.onopen slug: Web/API/WebSocket/onopen browser-compat: api.WebSocket.onopen --- -<div>{{APIRef("Web Sockets API")}}</div> +{{APIRef("Web Sockets API")}} -<p>La propriété <strong><code>WebSocket.onopen</code></strong> est un <a href="/fr/docs/Web/Events/Event_handlers">gestionnaire d'évènement</a> qui est appelé lorsque l'état (<a href="/fr/docs/Web/API/WebSocket/readyState"><code>readyState</code></a>) de la connexion <a href="/fr/docs/Web/API/WebSocket"><code>WebSocket</code></a> passe à <code>1</code>, indiquant que la connexion est prête pour l'envoi et la réception de données. Lorsqu'il est appelé, ce gestionnaire d'évènement reçoit un objet <a href="/fr/docs/Web/API/Event"><code>Event</code></a> en paramètre.</p> +La propriété **`WebSocket.onopen`** est un [gestionnaire d'évènement](/fr/docs/Web/Events/Event_handlers) qui est appelé lorsque l'état ([`readyState`](/fr/docs/Web/API/WebSocket/readyState)) de la connexion [`WebSocket`](/fr/docs/Web/API/WebSocket) passe à `1`, indiquant que la connexion est prête pour l'envoi et la réception de données. Lorsqu'il est appelé, ce gestionnaire d'évènement reçoit un objet [`Event`](/fr/docs/Web/API/Event) en paramètre. -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js uneWebSocket.onopen = function(event) { console.log("La WebSocket est désormais ouverte."); -};</pre> +}; +``` -<h2 id="value">Valeur</h2> +## Valeur -<p>Un objet <a href="/fr/docs/Web/API/EventListener"><code>EventListener</code></a>.</p> +Un objet [`EventListener`](/fr/docs/Web/API/EventListener). -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} diff --git a/files/fr/web/api/websocket/open_event/index.md b/files/fr/web/api/websocket/open_event/index.md index cfa28af7bb..29c707650a 100644 --- a/files/fr/web/api/websocket/open_event/index.md +++ b/files/fr/web/api/websocket/open_event/index.md @@ -3,55 +3,58 @@ title: 'WebSocket : évènement open' slug: Web/API/WebSocket/open_event browser-compat: api.WebSocket.open_event --- -<div>{{APIRef}}</div> +{{APIRef}} -<p>L'évènement <code>open</code> est déclenché lorsqu'une connexion avec une <code>WebSocket</code> est ouverte.</p> +L'évènement `open` est déclenché lorsqu'une connexion avec une `WebSocket` est ouverte. <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/Event"><code>Event</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/onopen"><code>onopen</code></a></td> - </tr> - </tbody> + <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/Event"><code>Event</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/onopen"><code>onopen</code></a> + </td> + </tr> + </tbody> </table> -<h2 id="examples">Exemples</h2> +## Exemples -<pre class="brush: js"> +```js // Crée une connexion WebSocket const socket = new WebSocket('ws://localhost:8080'); // La connexion est ouverte -socket.addEventListener('open', (event) => { +socket.addEventListener('open', (event) => { socket.send('Coucou serveur !'); -});</pre> +}); +``` -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} -<h2 id="see_also">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/API/WebSocket/close_event">WebSocket : évènement <code>close</code></a></li> - <li><a href="/fr/docs/Web/API/WebSocket/error_event">WebSocket : évènement <code>error</code></a></li> - <li><a href="/fr/docs/Web/API/WebSocket/message_event">WebSocket : évènement <code>message</code></a></li> - <li><a href="/fr/docs/Web/API/WebSockets_API/Writing_WebSocket_client_applications">Écrire des applications clientes WebSocket</a></li> - </ul> +- [WebSocket : évènement `close`](/fr/docs/Web/API/WebSocket/close_event) +- [WebSocket : évènement `error`](/fr/docs/Web/API/WebSocket/error_event) +- [WebSocket : évènement `message`](/fr/docs/Web/API/WebSocket/message_event) +- [Écrire des applications clientes WebSocket](/fr/docs/Web/API/WebSockets_API/Writing_WebSocket_client_applications) diff --git a/files/fr/web/api/websocket/protocol/index.md b/files/fr/web/api/websocket/protocol/index.md index cf2bc5d053..6f086e74e4 100644 --- a/files/fr/web/api/websocket/protocol/index.md +++ b/files/fr/web/api/websocket/protocol/index.md @@ -3,24 +3,24 @@ title: WebSocket.protocol slug: Web/API/WebSocket/protocol browser-compat: api.WebSocket.protocol --- -<p>{{APIRef("Web Sockets API")}}</p> +{{APIRef("Web Sockets API")}} -<p>La propriété en lecture seule <strong><code>WebSocket.protocol</code></strong> renvoie le nom du sous protocole sélectionné par le serveur. Cette valeur sera l'une des chaînes de caractères du paramètre <code>protocols</code> utilisé lors de la création de l'objet <a href="/fr/docs/Web/API/WebSocket"><code>WebSocket</code></a> ou la chaîne vide si aucune connexion n'est établie.</p> +La propriété en lecture seule **`WebSocket.protocol`** renvoie le nom du sous protocole sélectionné par le serveur. Cette valeur sera l'une des chaînes de caractères du paramètre `protocols` utilisé lors de la création de l'objet [`WebSocket`](/fr/docs/Web/API/WebSocket) ou la chaîne vide si aucune connexion n'est établie. -<h2 id="syntax">Syntax</h2> +## Syntax -<pre class="brush: js"> +```js var protocol = uneWebSocket.protocol; -</pre> +``` -<h2 id="value">Valeur</h2> +## Valeur -<p>Une chaîne de caractères <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a>.</p> +Une chaîne de caractères [`DOMString`](/fr/docs/Web/API/DOMString). -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} diff --git a/files/fr/web/api/websocket/readystate/index.md b/files/fr/web/api/websocket/readystate/index.md index d33114d5f5..e764eab3b1 100644 --- a/files/fr/web/api/websocket/readystate/index.md +++ b/files/fr/web/api/websocket/readystate/index.md @@ -3,19 +3,19 @@ title: WebSocket.readyState slug: Web/API/WebSocket/readyState browser-compat: api.WebSocket.readyState --- -<p>{{APIRef("Web Sockets API")}}</p> +{{APIRef("Web Sockets API")}} -<p>La propriété en lecture seule <strong><code>WebSocket.readyState</code></strong> renvoie l'état courant de la connexion <a href="/fr/docs/Web/API/WebSocket"><code>WebSocket</code></a>.</p> +La propriété en lecture seule **`WebSocket.readyState`** renvoie l'état courant de la connexion [`WebSocket`](/fr/docs/Web/API/WebSocket). -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js var readyState = uneWebSocket.readyState; -</pre> +``` -<h2 id="value">Valeur</h2> +## Valeur -<p>Cette propriété peut valoir l'une des valeurs de type <code>unsigned short</code> suivantes :</p> +Cette propriété peut valoir l'une des valeurs de type `unsigned short` suivantes : <table class="standard-table"> <tbody> @@ -47,10 +47,10 @@ var readyState = uneWebSocket.readyState; </tbody> </table> -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} 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 --- -<p>{{APIRef("Web Sockets API")}}</p> +{{APIRef("Web Sockets API")}} -<p>La méthode <strong><code>WebSocket.send()</code></strong> rajoute les données indiquées à la queue pour transmission au serveur via la connexion WebSocket, augmentant ainsi la valeur de <code>bufferedAmount</code> 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.</p> +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. -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js WebSocket.send("Coucou serveur !"); -</pre> +``` -<h3 id="parameters">Paramètres</h3> +### Paramètres -<dl> - <dt><code>data</code></dt> - <dd>Les données à envoyer au serveur. La valeur peut avoir un des types suivants : - <dl> - <dt><a href="/fr/docs/Web/API/USVString"><code>USVString</code></a></dt> - <dd>Une chaîne de caractères. Cette chaîne est ajoutée au tampon au format UTF-8 et la valeur de <code>bufferedAmount</code> est augmentée du nombre d'octets nécessaires pour représenter cette chaîne de caractères UTF-8.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer"><code>ArrayBuffer</code></a></dt> - <dd>Les données binaires peuvent aussi être envoyées avec un tableau typé. Son contenu binaire est mis en tampon et la valeur de <code>bufferedAmount</code> est augmentée du nombre d'octets nécessaires.</dd> - <dt><a href="/fr/docs/Web/API/Blob"><code>Blob</code></a></dt> - <dd>Lorsqu'une valeur <code>Blob</code> est fournie, les données brutes du blob sont rajoutées à la queue pour être transmises dans une <i lang="en">frame</i> binaire. La valeur de <code>bufferedAmount</code> est augmentée du nombre d'octets utilisés pour représenter ces données brutes.</dd> - <dt><a href="/fr/docs/Web/API/ArrayBufferView"><code>ArrayBufferView</code></a></dt> - <dd>Il est possible d'envoyer n'importe quel objet étant <a href="/fr/docs/Web/JavaScript/Typed_arrays">un tableau typé JavaScript</a> sous la forme d'une <i lang="en">frame</i> binaire. Le contenu des données binaires est rajouté à la queue dans le tampon et la valeur de <code>bufferedAmount</code> est augmentée du nombre d'octets correspondant.</dd> - </dl> - </dd> -</dl> +- `data` -<h3 id="exceptions_thrown">Exceptions levées</h3> + - : Les données à envoyer au serveur. La valeur peut avoir un des types suivants : -<dl> - <dt><code>INVALID_STATE_ERR</code></dt> - <dd>La connexion n'est pas ouverte actuellement.</dd> - <dt><code>SYNTAX_ERR</code></dt> - <dd>Les données sont une chaîne de caractères pour laquelle il existe des <i lang="en">surrogates</i> non appairés.</dd> -</dl> + - [`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) -<div class="note"> - <p><strong>Note :</strong> Pour Gecko 6.0, l'implémentation de <code>send()</code> 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.</p> + - : Lorsqu'une valeur `Blob` est fournie, les données brutes du blob sont rajoutées à la queue pour être transmises dans une - <p>Avec Gecko 11.0, la prise en charge des <a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer"><code>ArrayBuffer</code></a> est implémentée mais pas celle pour les objets <a href="/fr/docs/Web/API/Blob"><code>Blob</code></a>.</p> -</div> + <i lang="en">frame</i> -<h2 id="specifications">Spécifications</h2> + binaire. La valeur de `bufferedAmount` est augmentée du nombre d'octets utilisés pour représenter ces données brutes. -<p>{{Specifications}}</p> + - [`ArrayBufferView`](/fr/docs/Web/API/ArrayBufferView) -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> + - : 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 -<p>{{Compat}}</p> + <i lang="en">frame</i> + + 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 + + <i lang="en">surrogates</i> + + 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}} diff --git a/files/fr/web/api/websocket/url/index.md b/files/fr/web/api/websocket/url/index.md index acaa13de14..57e7c95c62 100644 --- a/files/fr/web/api/websocket/url/index.md +++ b/files/fr/web/api/websocket/url/index.md @@ -3,24 +3,24 @@ title: WebSocket.url slug: Web/API/WebSocket/url browser-compat: api.WebSocket.url --- -<p>{{APIRef("Web Sockets API")}}</p> +{{APIRef("Web Sockets API")}} -<p>La propriété en lecture seule <strong><code>WebSocket.url</code></strong> renvoie l'URL absolue de la <a href="/fr/docs/Web/API/WebSocket"><code>WebSocket</code></a> telle que résolue par le constructeur.</p> +La propriété en lecture seule **`WebSocket.url`** renvoie l'URL absolue de la [`WebSocket`](/fr/docs/Web/API/WebSocket) telle que résolue par le constructeur. -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js var url = aWebSocket.url; -</pre> +``` -<h2 id="value">Valeur</h2> +## Valeur -<p>Une chaîne de caractères <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a>.</p> +Une chaîne de caractères [`DOMString`](/fr/docs/Web/API/DOMString). -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} diff --git a/files/fr/web/api/websocket/websocket/index.md b/files/fr/web/api/websocket/websocket/index.md index 94ff66e828..e0bf4c0eab 100644 --- a/files/fr/web/api/websocket/websocket/index.md +++ b/files/fr/web/api/websocket/websocket/index.md @@ -3,38 +3,34 @@ title: WebSocket() slug: Web/API/WebSocket/WebSocket browser-compat: api.WebSocket.WebSocket --- -<p>{{APIRef("Web Sockets API")}}</p> +{{APIRef("Web Sockets API")}} -<p>Le constructeur <code><strong>WebSocket()</strong></code> renvoie un nouvel objet <a href="/fr/docs/Web/API/WebSocket"><code>WebSocket</code></a>.</p> +Le constructeur **`WebSocket()`** renvoie un nouvel objet [`WebSocket`](/fr/docs/Web/API/WebSocket). -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> -var <em>aWebSocket</em> = new WebSocket(<em>url</em> [, protocols]); -</pre> +```js +var aWebSocket = new WebSocket(url [, protocols]); +``` -<h3 id="parameters">Paramètres</h3> +### Paramètres -<dl> - <dt><code>url</code></dt> - <dd>L'URL à laquelle se connecter. Cela devrait être l'URL à laquelle le serveur WebSocket répondra.</dd> - <dt><code>protocols</code> {{optional_inline}}</dt> - <dd>Une valeur qui est une chaîne de caractères représentant un seul protocole ou un tableau de chaînes de caractères représentant une liste de protocoles. Ces chaînes de caractères indiquent des sous-protocoles : un serveur donné pourra implémenter différents sous-protocoles WebSocket (on peut vouloir qu'un serveur soit capable de gérér différents types d'interaction selon le <code>protocol</code> indiqué). Si cette valeur est absence, c'est un tableau vide qui est utilisé par défaut : <code>[]</code>.</dd> -</dl> +- `url` + - : L'URL à laquelle se connecter. Cela devrait être l'URL à laquelle le serveur WebSocket répondra. +- `protocols` {{optional_inline}} + - : Une valeur qui est une chaîne de caractères représentant un seul protocole ou un tableau de chaînes de caractères représentant une liste de protocoles. Ces chaînes de caractères indiquent des sous-protocoles : un serveur donné pourra implémenter différents sous-protocoles WebSocket (on peut vouloir qu'un serveur soit capable de gérér différents types d'interaction selon le `protocol` indiqué). Si cette valeur est absence, c'est un tableau vide qui est utilisé par défaut : `[]`. -<h3 id="exceptions_thrown">Exceptions levées</h3> +### Exceptions levées -<dl> - <dt><code>SECURITY_ERR</code></dt> - <dd>Le port ciblé par la tentative de connexion est bloqué.</dd> - <dt><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError">SyntaxError</a></dt> - <dd>L'URL est invalide.</dd> -</dl> +- `SECURITY_ERR` + - : Le port ciblé par la tentative de connexion est bloqué. +- [SyntaxError](/fr/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError) + - : L'URL est invalide. -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} |