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/index.html | 162 ++++++++++++++++++++++++++++++++ 1 file changed, 162 insertions(+) create mode 100644 files/fr/web/api/eventsource/index.html (limited to 'files/fr/web/api/eventsource/index.html') 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

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