Eventos numa resposta HTTP aberta
O SSE (Server-Sent Events) é um mecanismo de envio de eventos do servidor para o navegador por uma resposta HTTP mantida aberta. Uma página pode acompanhar o progresso de uma exportação conforme o servidor envia atualizações, sem fazer uma nova consulta a cada intervalo.
O objeto EventSource abre a conexão com o endereço do fluxo. O servidor responde com o tipo text/event-stream e texto em UTF-8. Cada mensagem termina com uma linha em branco, que permite ao navegador separar os eventos mesmo quando vários chegam pela mesma conexão. Esses detalhes estão na especificação do WHATWG.
Progresso de uma exportação
Neste exemplo, o servidor informa que uma exportação chegou à metade do processamento. Ele envia este trecho no corpo da resposta, seguido de uma linha em branco:
id: 42data: 50%O navegador recebe um evento do tipo message, cujo campo data contém o texto 50%. A aplicação interpreta esse texto e atualiza o indicador de progresso. O identificador 42 permite indicar a posição no fluxo, mas não mede o trabalho realizado. O percentual precisa ser calculado pelo processo de exportação.
Reconexão e recuperação do histórico
Após uma interrupção que permita nova tentativa, o EventSource procura restabelecer a conexão. Quando há um último identificador não vazio, envia esse valor no cabeçalho Last-Event-ID. No exemplo, o valor 42 informa ao servidor a posição recebida pelo navegador.
A recuperação dos eventos seguintes exige que o servidor preserve o histórico e interprete esse cabeçalho. Você pode conferir a retomada interrompendo a conexão durante uma exportação e comparando os eventos recebidos com os produzidos. A conexão pode voltar a funcionar mesmo que uma atualização anterior tenha sido perdida.
Dúvidas frequentes
Perguntas frequentes sobre SSE
- O SSE envia mensagens nos dois sentidos?
- O fluxo de eventos vai do servidor para o cliente. Uma ação da interface pode usar outra requisição HTTP para enviar uma instrução ao servidor.
- A conexão recupera eventos após uma queda?
- O EventSource tenta restabelecer o fluxo após interrupções recuperáveis. O cabeçalho Last-Event-ID informa a última posição conhecida quando há um identificador não vazio. O servidor precisa recuperar e reenviar o histórico correspondente.
- Como encerrar o recebimento na página?
- A aplicação chama close() no objeto EventSource para encerrar a conexão e as tentativas de reconexão. O servidor também pode responder com HTTP 204 para indicar que o navegador deve parar de reconectar.
Para continuar
Recursos relacionados
Site de referência
Desenvolvimento Colaborativo da Dev Side Studio
Orientação técnica ao vivo para revisar o fluxo de eventos e investigar atualizações perdidas após uma reconexão.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O SSE permite acompanhar o andamento de uma tarefa na interface durante a execução no servidor.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.