Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

EventSource()

Baseline Widely available

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

O construtor EventSource() retorna uma nova EventSource, que representa um recurso remoto.

Sintaxe

eventSource = new EventSource(url, configuration);

Parâmetros

url

Uma USVString que representa a localização de um recurso remoto servindo os eventos/mensagens.

configuration Optional

Fornece opções para configurar a nova conexão. Os atributos possíveis são:

  • withCredentials, valor padrão false, indicando se o CORS deve ser instruído a incluir credenciais.

Exemplos

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);
};

Nota: Você pode encontrar um exemplo completo no GitHub — veja Simple SSE demo using PHP.

Especificações

Specification
HTML
# dom-eventsource-dev

Compatibilidade com navegadores

See also