EventSource: EventSource() Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Der EventSource() Konstruktor gibt eine neu erstellte EventSource zurück, die eine entfernte Ressource darstellt.

Syntax

js
new EventSource(url)
new EventSource(url, options)

Parameter

url

Ein String, der den Ort der entfernten Ressource darstellt, die die Ereignisse/Nachrichten bereitstellt.

options Optional

Bietet Optionen zur Konfiguration der neuen Verbindung. Die möglichen Einträge sind:

withCredentials Optional

Ein boolescher Wert, der standardmäßig auf false steht. Er gibt an, ob CORS mit Eingeschlossenen Anmeldeinformationen gesetzt werden soll.

Beispiele

js
const evtSource = new EventSource("sse.php");
const eventList = document.querySelector("ul");

evtSource.onmessage = (e) => {
  const newElement = document.createElement("li");

  newElement.textContent = `message: ${e.data}`;
  eventList.appendChild(newElement);
};

Hinweis: Sie können ein vollständiges Beispiel auf GitHub finden — siehe Einfaches SSE-Demo mit PHP.

Spezifikationen

Specification
HTML Standard
# dom-eventsource-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch