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 |
|
Função JavaScript a ser chamada quando um erro acontecer. |
onmessage |
|
Função JavaScript a ser chamada quando uma mensagem sem o campo event surgir. |
onopen |
|
Função JavaScript a ser chamada quando a conexão for aberta. |
readyState |
long |
O estado da conexão, deve ser 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
idpara 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.
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
principalpara ser usado norequest. Isto não pode sernull. scriptContext- O
script contextpara ser usado norequest. Pode sernull. ownerWindow- A associated window para o request. Pode ser
null. url- A
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 | ? | ? | ? | ? |