Evento onmessage

Eventos DOM Objeto Evento

Definição e uso

Ocorre o evento onmessage quando recebe uma mensagem através do EventSource.

O objeto event do evento onmessage suporta os seguintes atributos:

  • data - Contém a mensagem real
  • origin - URL do documento que invoca o evento
  • lastEventId - Identificador da última mensagem vista no fluxo de eventos

Eventos relacionados:

  • onopen - Ocorre ao abrir a conexão com o servidor
  • onerror - Ocorre ao ocorrer um problema

Para obter mais informações sobre Eventos de Servidor Enviados (Server-Sent Events), aprenda em nossos Tutorial de Eventos de Servidor Enviados por HTML5.

Exemplo

Exemplo 1

Crie um novo objeto EventSource e especifique a URL da página que envia as atualizações.

Cada vez que receber uma atualização, ocorrerá o evento onmessage. Quando o evento onmessage ocorrer, os dados recebidos serão colocados no elemento <div> com id="myDIV":

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

Experimente pessoalmente

Exemplo 2

Obter a URL do documento que invoca o evento onmessage:

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

O resultado será:

https://www.codew3c.com/

Experimente pessoalmente

Sintaxe

object.onmessage = function(){myScript};

Experimente pessoalmente

Uso do método addEventListener():

object.addEventListener("message", myScript);

Experimente pessoalmente

Notas:O Internet Explorer 8 ou versões mais antigas não suportam Método addEventListener().

Detalhes técnicos

Bolha: Não suportado
Desligável: Não suportado
Tipo de evento: Evento

Suporte do navegador

Os números na tabela indicam a primeira versão do navegador que suporta completamente o evento.

Eventos Chrome IE Firefox Safari Opera
onmessage 9.0 Não suportado 6.0 5.0 11.0
Eventos DOM Objeto Evento