Evento onmessage

Definición y uso

Se produce el evento onmessage cuando se recibe un mensaje a través del EventSource.

El objeto event del evento onmessage admite las siguientes propiedades:

  • data - Contiene el mensaje real
  • origin - URL del documento que llama al evento
  • lastEventId - Identificador de la última mensaje visto en el flujo de eventos

Eventos relacionados:

  • onopen - Se produce cuando se abre la conexión con el servidor
  • onerror - Se produce cuando ocurre un problema

Para obtener más información sobre los eventos del servidor enviados (Server-Sent Events), aprende en nuestros Tutoriales de eventos del servidor HTML5.

Ejemplo

Ejemplo 1

Crear un nuevo objeto EventSource y especificar la URL de la página que envía las actualizaciones.

Cada vez que se recibe una actualización, se produce el evento onmessage. Cuando ocurre el evento onmessage, se colocará los datos recibidos en el elemento <div> con id="myDIV":

var source = new EventSource("demo_sse.php");
source.onmessage = function(event) {
  document.getElementById("myDIV").innerHTML += event.data + "<br>";
};

Prueba por ti mismo

Ejemplo 2

Obtener la URL del documento que llama al evento onmessage:

var source = new EventSource("demo_sse.php");
source.onmessage = function(event) {
  document.getElementById("myDIV").innerHTML = event.origin;
};

El resultado será:

https://www.codew3c.com/

Prueba por ti mismo

Sintaxis

object.onmessage = function(){myScript};

Prueba por ti mismo

Uso de addEventListener()

object.addEventListener("message", myScript);

Prueba por ti mismo

Notas:Internet Explorer 8 o versiones anteriores no lo soportan Método addEventListener().

Detalles técnicos

Burbuja: No soportado
Desactivable: No soportado
Tipos de eventos: Evento

Compatibilidad del navegador

Los números en la tabla indican la versión del navegador que admite completamente el evento.

Eventos Chrome IE Firefox Safari Opera
onmessage 9.0 No soportado 6.0 5.0 11.0