| [ Web Proxy ] |
| Viewing: https://developer.mozilla.org/fr/docs/Web/API/EventSource | [Back] [Original] |
Get to know MDN better
Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.
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.
EventSource()Cette mthode cre un nouvel objet EventSource partir de l'objet String fourni.
Cette interface hrite galement des proprits fournies par l'objet parent : EventTarget.
EventSource.readyState Lecture seuleUn 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 seuleUn objet String qui reprsente l'URL de la source.
EventSource.withCredentials Lecture seuleUn boolen qui indique si l'objet EventSource a t instanci avec les paramtres d'authentification CORS (true) ou non (false, la valeur par dfaut).
EventSource.onerrorUn gestionnaire d'vnement qui est appel lorsqu'une erreur se produit et que l'vnement error est envoy l'objet EventSource.
EventSource.onmessageUn 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.onopenUn gestionnaire d'vnement qui est appel lorsqu'un vnement open est reu, ce qui indique que la connexion vient d'tre ouverte.
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.
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.
| Spcification |
|---|
| HTML # the-eventsource-interface |
Cette page a t modifie le 22 mai 2026 par les contributeurices du MDN.
EventSourceCertaines parties de ce contenu sont protges par le droit d'auteur 19982026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.
| Web Proxy Viewer | New URL | Original Page |