From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/web/api/eventsource/close/index.html | 145 ++++++++++++++++++++++ files/fr/web/api/eventsource/index.html | 162 +++++++++++++++++++++++++ files/fr/web/api/eventsource/onopen/index.html | 62 ++++++++++ 3 files changed, 369 insertions(+) create mode 100644 files/fr/web/api/eventsource/close/index.html create mode 100644 files/fr/web/api/eventsource/index.html create mode 100644 files/fr/web/api/eventsource/onopen/index.html (limited to 'files/fr/web/api/eventsource') diff --git a/files/fr/web/api/eventsource/close/index.html b/files/fr/web/api/eventsource/close/index.html new file mode 100644 index 0000000000..eb65e1817a --- /dev/null +++ b/files/fr/web/api/eventsource/close/index.html @@ -0,0 +1,145 @@ +--- +title: EventSource.close() +slug: Web/API/EventSource/close +tags: + - API + - EventSource + - Evénement serveur + - Fonction + - Méthode + - Reference + - Server-sent events + - close +translation_of: Web/API/EventSource/close +--- +
{{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).

+ +
+

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

+
+ +

Syntaxe

+ +
eventSource.close();
+ +

Paramètres

+ +

Aucun.

+ +

Valeur de retour

+ +

Nulle.

+ +

Exemples

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

+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('HTML WHATWG', "comms.html#dom-eventsource-close", "close()")}}{{Spec2('HTML WHATWG')}}Initial definition
+ + + +

Compatibilité des navigateurs

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
EventSource support6{{CompatNo}}{{CompatGeckoDesktop("6.0")}}{{CompatNo}}{{CompatVersionUnknown}}5
Disponible en workers dédiés et partagés[1]{{CompatVersionUnknown}}{{CompatNo}}{{CompatGeckoDesktop("53.0")}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
EventSource support4.445{{CompatNo}}124.1
Disponible en workers dédiés et partagés[1]{{CompatVersionUnknown}}{{CompatGeckoMobile("53.0")}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +

[1] But not service workers as yet.

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/eventsource/index.html b/files/fr/web/api/eventsource/index.html new file mode 100644 index 0000000000..4a80f6f528 --- /dev/null +++ b/files/fr/web/api/eventsource/index.html @@ -0,0 +1,162 @@ +--- +title: EventSource +slug: Web/API/EventSource +tags: + - API + - Interface + - Reference +translation_of: Web/API/EventSource +--- +
{{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.

+ +

Constructeur

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

Propriétés

+ +

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

Gestionnaires d'évènement

+ +
+
{{domxref("EventSource.onerror")}}
+
Un objet {{domxref("EventHandler")}} 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 {{domxref("EventHandler")}} 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 {{domxref("EventHandler")}} qui est appelé lorsqu'un évènement {{event("open")}} est reçu, ce qui indique que la connexion vient d'être ouverte.
+
+ +

Méthodes

+ +

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

Exemples

+ +
var evtSource = new EventSource('sse.php');
+var eventList = document.querySelector('ul');
+
+evtSource.onmessage = function(e) {
+  var newElement = document.createElement("li");
+
+  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

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Support simple6{{CompatNo}}{{CompatGeckoDesktop("6.0")}}{{CompatNo}}{{CompatVersionUnknown}}5
Disponible dans les workers dédiés et partagés[1]{{CompatVersionUnknown}}{{CompatNo}}{{CompatGeckoDesktop("53.0")}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Support simple4.445{{CompatNo}}124.1
Disponible dans les workers dédiés et partagés[1]{{CompatVersionUnknown}}{{CompatGeckoMobile("53.0")}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +

[1] Pas encore disponible pour les service workers.

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/eventsource/onopen/index.html b/files/fr/web/api/eventsource/onopen/index.html new file mode 100644 index 0000000000..2753fb2197 --- /dev/null +++ b/files/fr/web/api/eventsource/onopen/index.html @@ -0,0 +1,62 @@ +--- +title: EventSource.onopen +slug: Web/API/EventSource/onopen +tags: + - API + - Event Handler + - EventSource + - Propriété + - Reference +translation_of: Web/API/EventSource/onopen +--- +
{{APIRef('Server Sent Events')}}
+ +

La propriété onopen de l'interface {{domxref("EventSource")}} est un {{domxref("EventHandler")}} qui est appelé lorsqu'un est évènement {{event("open")}} est reçu, indiquant que la connexion vient d'être établie.

+ +

Syntaxe

+ +
eventSource.onopen = function
+ +

Exemples

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

+ + -- cgit v1.2.3-54-g00ecf