MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

A interface EventSource é usada para receber eventos enviados pelo servidor (server-sent events). Ele se conecta via HTTP em um servidor e recebe eventos com o formato text/event-stream  sem fechar a conexão.

Você pode configurar o atributo onmessage  para uma função JavaScript receber mensagens não tipadas (ou seja, mensagens sem o campo event). Você também pode chamar addEventListener() para responder a eventos assim como qualquer outra fonte de eventos

Veja Usando eventos enviados do servidor para mais detalhes.

Visão geral do Metodo

void close();
void init(in nsIPrincipal principal, in nsIScriptContext scriptContext, in nsPIDOMWindow ownerWindow, in DOMString url); Native code only!

Properties

Attribute Type Description
onerror nsIDOMEventListener Função JavaScript a ser chamada quando um erro acontecer.
onmessage nsIDOMEventListener Função JavaScript a ser chamada quando uma mensagem sem o campo event surgir.
onopen nsIDOMEventListener Função JavaScript a ser chamada quando a conexão for aberta.
readyState long

O estado da conexão, deve ser CONNECTING, OPEN, ou CLOSED.

Somente leitura.

url DOMString Somente leitura.

Além desses atributos, existem dois atributos internos que não são expostos diretamente:

reconnection time
É o tempo, em milisegundos, usado para determinar quanto esperar depois da falha de uma tentativa de conexão, para tentar novamente.
last event ID string
Inicialmente é uma string vazia; o servidor pode enviar uma mensaggem com o campo id para ajustar esse valor.

Constantes

Constant Value Description
CONNECTING 0 A conexão está sendo estabelecida
OPEN 1 A conexão está aberta e enviando eventos
CLOSED 2 A conexão não está sendo estabelecida, foi encerrada ou aconteceu um erro fatal.

Métodos

close()

Encerra a conexão, se existir, e altera o atributo readyState para CLOSED. Se a conexão já está fechada, o método não faz nada.

void close();
Parametros

Nenhum.

Native code only!

init

Inicializa o objeto para o uso por um código C++ com os campos principal, script context, e owner window que devem ser utilizados.

void init(
  in nsIPrincipal principal,
  in nsIScriptContext scriptContext,
  in nsPIDOMWindow ownerWindow,
  in DOMString url
);
Parametros
principal
O principal para ser usado no request. Isto não pode ser null.
scriptContext
O script context para ser usado no request. Pode ser null.
ownerWindow
A associated window para o request. Pode ser null.
url
EventSource's URL. Isto não pode ser vazio.

Veja também

Compatibilidade de Navegadores

Dependência Chrome Firefox (Gecko) Internet Explorer Opera Safari
EventSource support 9 6.0 (6.0) ? 11 5
CORS support 26 11.0 (11.0) ? 12 ?
Dependência Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
EventSource support 4.4 ? ? ? ?

 

Etiquetas do documento e colaboradores

Etiquetas: 
 Colaboradores desta página: Madalosso, leonardopandrade
 Última atualização por: Madalosso,