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/eventsource/close/index.md | 63 ++++++--------- files/fr/web/api/eventsource/index.md | 111 +++++++++++---------------- files/fr/web/api/eventsource/onopen/index.md | 63 ++++++--------- 3 files changed, 92 insertions(+), 145 deletions(-) (limited to 'files/fr/web/api/eventsource') 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 --- -
{{APIRef('WebSockets API')}}
+{{APIRef('WebSockets API')}} -

La fonction close() de l'interface {{domxref("EventSource")}} coupe la connection, si existante, et affecte à la variable {{domxref("EventSource.readyState")}} la valeur 2 (closed).

+La fonction **`close()`** de l'interface {{domxref("EventSource")}} coupe la connection, si existante, et affecte à la variable {{domxref("EventSource.readyState")}} la valeur `2` (closed). -
-

Note : Si la connexion est déjà fermé, la fonction n'agit pas.

-
+> **Note :** Si la connexion est déjà fermé, la fonction n'agit pas. -

Syntaxe

+## Syntaxe -
eventSource.close();
+ eventSource.close(); -

Paramètres

+### Paramètres -

Aucun.

+Aucun. -

Valeur de retour

+### Valeur de retour -

Nulle.

+Nulle. -

Exemples

+## Exemples -
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();
 }
-
+``` -
-

Note : Vous pouvez trouver un exemple complet sur GitHub — voir Demo simple de SSE utilisant PHP.

-
+> **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) -

Spécifications

+## Spécifications - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('HTML WHATWG', "comms.html#dom-eventsource-close", "close()")}}{{Spec2('HTML WHATWG')}}Initial definition
+| Specification | Status | Comment | +| ---------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------ | +| {{SpecName('HTML WHATWG', "comms.html#dom-eventsource-close", "close()")}} | {{Spec2('HTML WHATWG')}} | Initial definition | - +## Compatibilité des navigateurs -

Compatibilité des navigateurs

+{{Compat("api.EventSource.close")}} -

{{Compat("api.EventSource.close")}}

+## Voir aussi -

Voir aussi

- - +- {{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 --- -
{{APIRef("Websockets API")}}
+{{APIRef("Websockets API")}} -

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.

+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. -

Constructeur

+## Constructeur -
-
{{domxref("EventSource.EventSource", "EventSource()")}}
-
Cette méthode crée un nouvel objet EventSource à partir de l'objet {{domxref("USVString")}} fourni.
-
+- {{domxref("EventSource.EventSource", "EventSource()")}} + - : Cette méthode crée un nouvel objet `EventSource` à partir de l'objet {{domxref("USVString")}} fourni. -

Propriétés

+## Propriétés -

Cette interface hérite également des propriétés fournies par l'objet parent : {{domxref("EventTarget")}}.

+_Cette interface hérite également des propriétés fournies par l'objet parent : {{domxref("EventTarget")}}._ -
-
{{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).
-
+- {{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). -

Gestionnaires d'évènement

+### Gestionnaires d'évènement -
-
{{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.
-
+- {{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. -

Méthodes

+## Méthodes -

Cette interface hérite également de méthodes grâce à son objet parent : {{domxref("EventTarget")}}.

+_Cette interface hérite également de méthodes grâce à son objet parent : {{domxref("EventTarget")}}._ -
-
{{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.
-
+- {{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. -

Exemples

+## Exemples -
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);
-}
- -
-

Note : Un exemple complet est disponible sur GitHub, voir la démonstration SSE avec PHP.

-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('HTML WHATWG', "comms.html#the-eventsource-interface", "EventSource")}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.EventSource")}}

- -

Voir aussi

- - +} +``` + +> **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 --- -
{{APIRef('Server Sent Events')}}
+{{APIRef('Server Sent Events')}} -

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.

+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. -

Syntaxe

+## Syntaxe -
eventSource.onopen = function
+ eventSource.onopen = function -

Exemples

+## Exemples -
evtSource.onopen = function() {
+```js
+evtSource.onopen = function() {
   console.log("Connexion au serveur établie.");
-};
- -
-

Note : Vous pouvez trouver un exemple complet sur GitHub — voir Simple SSE demo using PHP.

-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaires
{{SpecName('HTML WHATWG', "comms.html#handler-eventsource-onopen", "onopen")}}{{Spec2('HTML WHATWG')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.EventSource.onopen")}}

- -

Voir aussi

- - +}; +``` + +> **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")}} -- cgit v1.2.3-54-g00ecf