Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é SSE?

    O SSE envia eventos do servidor ao navegador numa resposta HTTP aberta. O EventSource recebe as mensagens e tenta reconectar após interrupções do fluxo.

    Também chamado de: Server-Sent Events, SSE (Server-Sent Events)

    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: 42
    data: 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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano