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/eventsource | |
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/eventsource')
-rw-r--r-- | files/fr/web/api/eventsource/close/index.md | 63 | ||||
-rw-r--r-- | files/fr/web/api/eventsource/index.md | 111 | ||||
-rw-r--r-- | files/fr/web/api/eventsource/onopen/index.md | 63 |
3 files changed, 92 insertions, 145 deletions
diff --git a/files/fr/web/api/eventsource/close/index.md b/files/fr/web/api/eventsource/close/index.md index d7289f87ef..3846e79506 100644 --- a/files/fr/web/api/eventsource/close/index.md +++ b/files/fr/web/api/eventsource/close/index.md @@ -12,67 +12,48 @@ tags: - close translation_of: Web/API/EventSource/close --- -<div>{{APIRef('WebSockets API')}}</div> +{{APIRef('WebSockets API')}} -<p>La fonction <code><strong>close()</strong></code> de l'interface {{domxref("EventSource")}} coupe la connection, si existante, et affecte à la variable {{domxref("EventSource.readyState")}} la valeur <code>2</code> (closed).</p> +La fonction **`close()`** de l'interface {{domxref("EventSource")}} coupe la connection, si existante, et affecte à la variable {{domxref("EventSource.readyState")}} la valeur `2` (closed). -<div class="note"> -<p><strong>Note :</strong> Si la connexion est déjà fermé, la fonction n'agit pas.</p> -</div> +> **Note :** Si la connexion est déjà fermé, la fonction n'agit pas. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">eventSource.close();</pre> + eventSource.close(); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<p>Aucun.</p> +Aucun. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Nulle.</p> +Nulle. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">var bouton = document.querySelector('button'); +```js +var bouton = document.querySelector('button'); var evtSource = new EventSource('sse.php'); bouton.onclick = function() { console.log('Connection fermée'); evtSource.close(); } -</pre> +``` -<div class="note"> -<p><strong>Note :</strong> Vous pouvez trouver un exemple complet sur GitHub — voir <a href="https://github.com/mdn/dom-examples/tree/master/server-sent-events">Demo simple de SSE utilisant PHP.</a></p> -</div> +> **Note :** Vous pouvez trouver un exemple complet sur GitHub — voir [Demo simple de SSE utilisant PHP.](https://github.com/mdn/dom-examples/tree/master/server-sent-events) -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG', "comms.html#dom-eventsource-close", "close()")}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Initial definition</td> - </tr> - </tbody> -</table> +| Specification | Status | Comment | +| ---------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------ | +| {{SpecName('HTML WHATWG', "comms.html#dom-eventsource-close", "close()")}} | {{Spec2('HTML WHATWG')}} | Initial definition | -<ul> -</ul> +## Compatibilité des navigateurs -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +{{Compat("api.EventSource.close")}} -<p>{{Compat("api.EventSource.close")}}</p> +## Voir aussi -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("EventSource")}}</li> -</ul> +- {{domxref("EventSource")}} diff --git a/files/fr/web/api/eventsource/index.md b/files/fr/web/api/eventsource/index.md index 3ad72e5065..a47b9ebeff 100644 --- a/files/fr/web/api/eventsource/index.md +++ b/files/fr/web/api/eventsource/index.md @@ -7,53 +7,46 @@ tags: - Reference translation_of: Web/API/EventSource --- -<div>{{APIRef("Websockets API")}}</div> +{{APIRef("Websockets API")}} -<p>L'interface <strong><code>EventSource</code></strong> est utilisée afin de recevoir des évènements envoyés par le serveur. Elle se connecte à un serveur via HTTP et reçoit des évènements au format <code>text/event-stream</code> avant de clôturer la connexion.</p> +L'interface **`EventSource`** est utilisée afin de recevoir des évènements envoyés par le serveur. Elle se connecte à un serveur via HTTP et reçoit des évènements au format `text/event-stream` avant de clôturer la connexion. -<h2 id="Constructeur">Constructeur</h2> +## Constructeur -<dl> - <dt>{{domxref("EventSource.EventSource", "EventSource()")}}</dt> - <dd>Cette méthode crée un nouvel objet <code>EventSource</code> à partir de l'objet {{domxref("USVString")}} fourni.</dd> -</dl> +- {{domxref("EventSource.EventSource", "EventSource()")}} + - : Cette méthode crée un nouvel objet `EventSource` à partir de l'objet {{domxref("USVString")}} fourni. -<h2 id="Propriétés">Propriétés</h2> +## Propriétés -<p><em>Cette interface hérite également des propriétés fournies par l'objet parent : {{domxref("EventTarget")}}.</em></p> +_Cette interface hérite également des propriétés fournies par l'objet parent : {{domxref("EventTarget")}}._ -<dl> - <dt>{{domxref("EventSource.readyState")}} {{readonlyinline}}</dt> - <dd>Un nombre qui représente l'état de la connexion. Les valeurs possibles sont <code>CONNECTING</code> (<code>0</code>) (connexion en cours), <code>OPEN</code> (<code>1</code>) (connexion ouverte), ou <code>CLOSED</code> (<code>2</code>) (connexion fermée).</dd> - <dt>{{domxref("EventSource.url")}} {{readonlyinline}}</dt> - <dd>Un objet {{domxref("DOMString")}} qui représente l'URL de la source.</dd> - <dt>{{domxref("EventSource.withCredentials")}} {{readonlyinline}}</dt> - <dd>Un booléen qui indique si l'objet <code>EventSource</code> a été instancié avec les paramètres d'authentification CORS (<code>true</code>) ou non (<code>false</code>, la valeur par défaut).</dd> -</dl> +- {{domxref("EventSource.readyState")}} {{readonlyinline}} + - : Un nombre qui représente l'état de la connexion. Les valeurs possibles sont `CONNECTING` (`0`) (connexion en cours), `OPEN` (`1`) (connexion ouverte), ou `CLOSED` (`2`) (connexion fermée). +- {{domxref("EventSource.url")}} {{readonlyinline}} + - : Un objet {{domxref("DOMString")}} qui représente l'URL de la source. +- {{domxref("EventSource.withCredentials")}} {{readonlyinline}} + - : Un booléen qui indique si l'objet `EventSource` a été instancié avec les paramètres d'authentification CORS (`true`) ou non (`false`, la valeur par défaut). -<h3 id="Gestionnaires_dévènement">Gestionnaires d'évènement</h3> +### Gestionnaires d'évènement -<dl> - <dt>{{domxref("EventSource.onerror")}}</dt> - <dd>Un objet {{event("Event_handlers", "event handler")}} qui est appelé lorsqu'une erreur se produit et que l'évènement {{event("error")}} est envoyé à l'objet <code>EventSource</code>.</dd> - <dt>{{domxref("EventSource.onmessage")}}</dt> - <dd>Un objet {{event("Event_handlers", "event handler")}} qui est appelé lorsqu'un évènement {{event("message")}} est reçu (ce qui signifie qu'on a reçu un message de la source).</dd> - <dt>{{domxref("EventSource.onopen")}}</dt> - <dd>Un objet {{event("Event_handlers", "event handler")}} qui est appelé lorsqu'un évènement {{event("open")}} est reçu, ce qui indique que la connexion vient d'être ouverte.</dd> -</dl> +- {{domxref("EventSource.onerror")}} + - : Un objet {{event("Event_handlers", "event handler")}} qui est appelé lorsqu'une erreur se produit et que l'évènement {{event("error")}} est envoyé à l'objet `EventSource`. +- {{domxref("EventSource.onmessage")}} + - : Un objet {{event("Event_handlers", "event handler")}} qui est appelé lorsqu'un évènement {{event("message")}} est reçu (ce qui signifie qu'on a reçu un message de la source). +- {{domxref("EventSource.onopen")}} + - : Un objet {{event("Event_handlers", "event handler")}} qui est appelé lorsqu'un évènement {{event("open")}} est reçu, ce qui indique que la connexion vient d'être ouverte. -<h2 id="Méthodes">Méthodes</h2> +## Méthodes -<p><em>Cette interface hérite également de méthodes grâce à son objet parent : {{domxref("EventTarget")}}.</em></p> +_Cette interface hérite également de méthodes grâce à son objet parent : {{domxref("EventTarget")}}._ -<dl> - <dt>{{domxref("EventSource.close()")}}</dt> - <dd>Cette méthode ferme la connexion s'il y en a une en cours et change la valeur de l'attribut <code>readyState</code> en <code>CLOSED</code>. Si la connexion est déjà fermée, la méthode ne fait rien.</dd> -</dl> +- {{domxref("EventSource.close()")}} + - : Cette méthode ferme la connexion s'il y en a une en cours et change la valeur de l'attribut `readyState` en `CLOSED`. Si la connexion est déjà fermée, la méthode ne fait rien. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">var evtSource = new EventSource('sse.php'); +```js +var evtSource = new EventSource('sse.php'); var eventList = document.querySelector('ul'); evtSource.onmessage = function(e) { @@ -61,35 +54,21 @@ evtSource.onmessage = function(e) { newElement.textContent = "message: " + e.data; eventList.appendChild(newElement); -}</pre> - -<div class="note"> -<p><strong>Note :</strong> Un exemple complet est disponible sur GitHub, <a href="https://github.com/mdn/dom-examples/tree/master/server-sent-events">voir la démonstration SSE avec PHP</a>.</p> -</div> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG', "comms.html#the-eventsource-interface", "EventSource")}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.EventSource")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Server-sent_events/Using_server-sent_events">Utiliser les évènements générés par le serveur</a></li> -</ul> +} +``` + +> **Note :** Un exemple complet est disponible sur GitHub, [voir la démonstration SSE avec PHP](https://github.com/mdn/dom-examples/tree/master/server-sent-events). + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------ | -------------------------------- | ------------ | +| {{SpecName('HTML WHATWG', "comms.html#the-eventsource-interface", "EventSource")}} | {{Spec2('HTML WHATWG')}} | | + +## Compatibilité des navigateurs + +{{Compat("api.EventSource")}} + +## Voir aussi + +- [Utiliser les évènements générés par le serveur](/fr/docs/Server-sent_events/Using_server-sent_events) diff --git a/files/fr/web/api/eventsource/onopen/index.md b/files/fr/web/api/eventsource/onopen/index.md index 64b0d58fb9..8cd75bbcb1 100644 --- a/files/fr/web/api/eventsource/onopen/index.md +++ b/files/fr/web/api/eventsource/onopen/index.md @@ -9,47 +9,34 @@ tags: - Reference translation_of: Web/API/EventSource/onopen --- -<div>{{APIRef('Server Sent Events')}}</div> +{{APIRef('Server Sent Events')}} -<p>La propriété <code><strong>onopen</strong></code> de l'interface {{domxref("EventSource")}} est un {{event("Event_handlers", "event handler")}} qui est appelé lorsqu'un est évènement {{event("open")}} est reçu, indiquant que la connexion vient d'être établie.</p> +La propriété **`onopen`** de l'interface {{domxref("EventSource")}} est un {{event("Event_handlers", "event handler")}} qui est appelé lorsqu'un est évènement {{event("open")}} est reçu, indiquant que la connexion vient d'être établie. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">eventSource.onopen = function</pre> + eventSource.onopen = function -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">evtSource.onopen = function() { +```js +evtSource.onopen = function() { console.log("Connexion au serveur établie."); -};</pre> - -<div class="note"> -<p><strong>Note :</strong> Vous pouvez trouver un exemple complet sur GitHub — voir <a href="https://github.com/mdn/dom-examples/tree/master/server-sent-events">Simple SSE demo using PHP.</a></p> -</div> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG', "comms.html#handler-eventsource-onopen", "onopen")}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.EventSource.onopen")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("EventSource")}}</li> -</ul> +}; +``` + +> **Note :** Vous pouvez trouver un exemple complet sur GitHub — voir [Simple SSE demo using PHP.](https://github.com/mdn/dom-examples/tree/master/server-sent-events) + +## Spécifications + +| Spécification | Statut | Commentaires | +| -------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------- | +| {{SpecName('HTML WHATWG', "comms.html#handler-eventsource-onopen", "onopen")}} | {{Spec2('HTML WHATWG')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.EventSource.onopen")}} + +## Voir aussi + +- {{domxref("EventSource")}} |