[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/API/EventSource [Back]  [Original]

EventSource - Les API Web | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

EventSource

Baseline Large disponibilit *

Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis janvier 2020.

* Certaines parties de cette fonctionnalit peuvent bnficier de prise en charge variables.

L'interface EventSource est utilise afin de recevoir des vnements envoys par le serveur. Elle se connecte un serveur via HTTP et reoit des vnements au format text/event-stream avant de clturer la connexion.

Dans cet article

Constructeur

EventSource()

Cette mthode cre un nouvel objet EventSource partir de l'objet String fourni.

Proprits

Cette interface hrite galement des proprits fournies par l'objet parent : EventTarget.

EventSource.readyState Lecture seule

Un nombre qui reprsente l'tat de la connexion. Les valeurs possibles sont CONNECTING (0) (connexion en cours), OPEN (1) (connexion ouverte), ou CLOSED (2) (connexion ferme).

EventSource.url Lecture seule

Un objet String qui reprsente l'URL de la source.

EventSource.withCredentials Lecture seule

Un boolen qui indique si l'objet EventSource a t instanci avec les paramtres d'authentification CORS (true) ou non (false, la valeur par dfaut).

Gestionnaires d'vnement

EventSource.onerror

Un gestionnaire d'vnement qui est appel lorsqu'une erreur se produit et que l'vnement error est envoy l'objet EventSource.

EventSource.onmessage

Un gestionnaire d'vnement qui est appel lorsqu'un vnement message est reu (ce qui signifie qu'on a reu un message de la source).

EventSource.onopen

Un gestionnaire d'vnement qui est appel lorsqu'un vnement open est reu, ce qui indique que la connexion vient d'tre ouverte.

Mthodes

Cette interface hrite galement de mthodes grce son objet parent : EventTarget.

EventSource.close()

Cette mthode 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 dj ferme, la mthode ne fait rien.

Exemples

js
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 dmonstration SSE avec PHP.

Spcifications

Spcification
HTML
# the-eventsource-interface

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page