We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

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

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

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,