EventSource

Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.

La interfaz EventSource se utiliza para recibir eventos server-side. Se realiza la conexión a un servidor sobre HTTP y se reciben eventos en formato text/event-stream sin tener que cerrar la conexión.

Constructor

EventSource()
Crea un nuevo  EventSource a partiendo de un valor USVString.

Propiedades

Esta interfaz también heredará propiedades de su antecesor, EventTarget.

EventSource.readyState Read only
Un número representando el estado de la conexión. Los valores posibles son CONECTANDO (0), ABIERTO (1), o CERRADO (2).
EventSource.url Read only
Un valor DOMString representando la URL de la fuente.
EventSource.withCredentials Read only
Un valor Boolean indicando si el objecto EventSource ha sido instanciado con credeciales CORS disponibles (true) o no (false, valor por defecto).

Manejadores de Eventos

EventSource.onerror
En un EventHandler que se invoca cuando ocurre un error y se envía el evento error a través del objeto EventSource.
EventSource.onmessage
Es un EventHandler que se invoca cuando se recibe un evento message, que indica que se ha enviado un mensaje desde la fuente.
EventSource.onopen
Es un EventHandler que se invoca cuando se recibe un evento open, que sucede en el momento que la conexión se abre.

Métodos

Esta interfaz también heredará métodos de su antecesor, EventTarget.

EventSource.close()
Cierra la conexión, si ésta existe, y asigna el valor CLOSED al atributo readyState. Si la conexión ya estaba cerrada, este método no hace nada.

Ejemplos

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: Está disponible un ejemplo completo en GitHub — ver Simple SSE demo using PHP.

Especificaciones

Especificación Estado Comentario
WHATWG HTML Living Standard
The definition of 'EventSource' in that specification.
Living Standard  

Compatibilidad de navegadoresEdit

Característica Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Soporte EventSource 6 No support 6.0 (6.0) No support (Yes) 5
Disponible en workers compartidos y dedicados[1] (Yes) No support 53.0 (53.0) No support (Yes) (Yes)
Características Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Soporte EventSource 4.4 45 No support 12 4.1
Disponible en workers compartidos y dedicados[1] (Yes) 53.0 (53.0) No support (Yes) (Yes)

[1] Pero todavía no disponible en service workers.

Ver también

Etiquetas y colaboradores del documento

 Colaboradores en esta página: Jabi
 Última actualización por: Jabi,