SSE para JSON

SSE Stream
Blank line separates events0 lines0 chars
JSON Array0

Formatted JSON shows up here

Paste id/event/data blocks separated by blank lines on the left, and each event becomes one item of the JSON array.

0 eventsWaiting for input

Um conversor focado nos dados push de Server-Sent Events (SSE). Cole à esquerda os blocos crus de id/event/data e, à direita, veja na hora um array JSON padrão em que cada evento enviado por push vira um único objeto com seu id, o nome do evento e o payload de dados já analisado.

Sugestões Relacionadas

O que é conversão de SSE para JSON?

Server-Sent Events (SSE) é um protocolo de streaming unidirecional em que o servidor escreve eventos de texto em UTF-8 sobre uma resposta HTTP do tipo `text/event-stream`. No arame, cada evento é uma sequência de linhas de campo como `id: 1`, `event: MESSAGE` e `data: {...}`, e uma linha em branco marca o fim daquele evento.

O SSE bruto é prático para transporte, mas é incômodo de ler e depurar. Os nomes de campo se repetem em todo evento, o payload JSON fica atrás de um prefixo `data:`, e streams longos viram um bloco único de texto. Converter SSE para JSON significa normalizar cada evento em um objeto simples e juntar todos os eventos em um único array JSON.

Este conversor segue as regras de interpretação de event-stream: ele divide pelas quebras de linha, trata a linha em branco como limite de despacho, remove exatamente um espaço opcional depois dos dois-pontos do campo, junta linhas data repetidas com quebras de linha e ignora comentários iniciados por dois-pontos. Depois analisa cada payload de data como JSON para preservar as estruturas aninhadas.

O resultado é um array JSON padrão e indentado, fácil de ler, copiar para o código, comparar com outra captura ou alimentar ferramentas downstream; qualquer payload que não dê para analisar é sinalizado, em vez de ser descartado.

Casos de uso

  • Depurar respostas em streaming de LLM ou agentes de IA que chegam em blocos de eventos SSE como STREAM_CHUNK ou CHUNK_DELTA
  • Transformar uma resposta text/event-stream copiada da aba Network do DevTools do navegador em JSON legível
  • Inspecionar eventos de heartbeat, ack e mensagem completa vindos de um backend de push em tempo real ou de chat
  • Converter dados push de SSE capturados em um array JSON antes de compartilhar com um colega para depuração
  • Extrair e expandir o payload de dados aninhado de cada evento sem remover manualmente os prefixos data:
  • Reproduzir offline um stream de push gravado e comparar a ordem dos eventos pelo id
  • Preparar dados de eventos SSE para análise, logs ou planilhas que esperam um array JSON
  • Verificar, durante a integração front-end e back-end, se o servidor emite os nomes de evento e o formato de payload esperados
  • Achatar campos data com várias linhas em um único valor analisado por objeto de evento
  • Inspecionar traces SSE vindos de proxies, gateways ou da saída do curl em uma forma estruturada e fácil de recolher
  • Converter para JSON streams de eventos no estilo Webhook ou de fila de mensagens que reutilizam o formato de transporte SSE
  • Aprender o formato de transporte de Server-Sent Events vendo como id, event e data mapeiam para objetos JSON

Como Usar

  1. Cole o stream bruto de SSE no textarea da esquerda, com as linhas id/event/data e uma linha em branco entre os eventos
  2. O lado direito atualiza automaticamente e mostra um array JSON com um objeto por evento
  3. Confira o painel de avisos se algum payload de dados não for JSON válido ou algum campo parecer malformado
  4. Use Copiar para copiar o array JSON inteiro, ou Amostra para carregar primeiro um exemplo embutido

Recursos

  • Converte um stream bruto de eventos SSE em um array JSON padrão, com um objeto para cada evento enviado por push
  • Agrupa as linhas em eventos pela linha em branco, seguindo o modelo de despacho de Server-Sent Events
  • Interpreta cada campo como campo: valor e remove o espaço único logo depois dos dois-pontos
  • Analisa todo payload de dados com JSON.parse, de forma que payloads aninhados virem objetos de verdade, e não strings escapadas
  • Mantém uma ordem estável de chaves id, event, data e converte ids numéricos em números JSON
  • Suporta campos data com várias linhas, linhas de comentário que começam com dois-pontos e streams sem uma linha em branco final
  • Reporta payloads de dados inválidos e campos desconhecidos ou malformados com número do bloco e da linha
  • Layout dividido com textarea de entrada e prévia JSON, com amostra, limpar, copiar e estatísticas de eventos; roda inteiramente no navegador

SSE para JSON vs formatador JSONL vs formatador JSON

Estas ferramentas lidam com formatos de entrada diferentes. Escolher a certa evita ter de remover prefixos e montar arrays manualmente.

FerramentaEntrada mais adequadaCapacidade principalCenário de uso
SSE para JSONBlocos id/event/data divididos por linhas em brancoEntende os campos SSE e analisa cada payload de dadosStreams de push do servidor, text/event-stream, chunks de streaming de IA
Formatador JSONLUm objeto JSON completo por linhaValida e formata cada linha de forma independenteLogs NDJSON, eventos arquivados, exportações separadas por linha
Formatador JSONUm objeto ou array JSON completoEmbeleza um único documento JSON inteiroRespostas de API, arquivos de configuração, payloads pontuais

Best Practices

Mantenha a linha em branco entre os eventos ao copiar um stream

A linha em branco é o que separa um evento SSE do seguinte. Se você remover as linhas em branco ao copiar, eventos distintos podem se fundir em um único bloco e a conversão deixará de corresponder à ordem original de despacho.

Use os números de bloco e de linha nos avisos para saltar direto ao problema

Quando um payload de dados falha ao analisar, o aviso indica o bloco do evento e a linha culpada. Compare esse bloco com um evento válido próximo para identificar uma chave truncada, uma aspa faltando ou chunks colados.

Lembre-se de que só o campo data é analisado como JSON

Os campos id, event e retry são metadados de transporte SSE e continuam como valores escalares. Não espere que o conversor analise JSON que apareça dentro do nome do evento ou do id; conteúdo estruturado pertence em data.

Monte os chunks parciais de streaming antes de converter uma mensagem completa

Muitos streams de IA enviam vários eventos pequenos STREAM_CHUNK que montam uma única mensagem. Converta a captura inteira primeiro para ver cada chunk como um item de array, depois una os payloads dos chunks no código da sua aplicação se precisar da mensagem final.

Higienize payloads sensíveis antes de compartilhar o JSON convertido

A conversão é local, mas assim que você copia o array JSON para um ticket ou chat, ele deixa a sua máquina. Remova tokens, ids de usuário e textos privados de conversa da saída antes de compartilhar.

Perguntas frequentes

O que é SSE (Server-Sent Events)?

SSE é uma forma padrão de o servidor enviar eventos de texto por push ao navegador sobre HTTP usando o tipo de conteúdo `text/event-stream`. Cada evento é feito de linhas de texto como `id`, `event` e `data`, e os eventos são separados uns dos outros por uma linha em branco.

Como esta ferramenta divide o stream em eventos?

Ela segue o modelo de despacho de SSE: a entrada é dividida em linhas, linhas consecutivas não vazias formam um bloco de evento, e uma linha em branco despacha esse bloco como um novo evento. Um bloco final sem linha em branco no fim ainda é emitido, e linhas de comentário que começam com dois-pontos são ignoradas.

Como fica o JSON de saída?

O resultado é um único array JSON. Cada evento de entrada vira um objeto com os campos que estavam presentes, na ordem estável id, event, data. O texto de `data` é analisado com JSON.parse, então um payload como `data: {"a":1}` vira um objeto aninhado `"data": {"a":1}` em vez de uma string escapada.

Por que o id sai como número na saída?

Tecnicamente os ids de SSE são strings, mas streams push reais quase sempre usam ids numéricos como `id: 0`. Quando um id é composto só por dígitos, o conversor o emite como um número JSON; qualquer outro id é mantido como string.

O que acontece quando o data ocupa várias linhas?

Segundo a especificação de SSE, várias linhas `data:` dentro de um mesmo evento são unidas com um caractere de quebra de linha antes de serem analisadas como um único valor. Se o texto unido não for JSON válido, o conversor mantém o texto bruto e acrescenta um aviso, para que nada se perca silenciosamente.

E se um payload de dados não for JSON válido?

Em vez de falhar a conversão inteira, aquele evento mantém o data bruto como uma string JSON, e a página mostra um aviso com o número do bloco e a mensagem de erro do parser. Os eventos válidos ao redor continuam sendo convertidos normalmente.

Qual a diferença entre SSE para JSON e o formatador JSONL?

O JSONL tem um objeto JSON completo em cada linha. O SSE, em vez disso, traz linhas rotuladas `id/event/data` agrupadas em eventos por linhas em branco, e só a parte de data é JSON. O SSE para JSON entende esses rótulos de campo e as fronteiras de evento por linha em branco, enquanto um formatador JSONL trataria cada linha de forma independente.

Este conversor envia meus dados de stream para algum lugar?

Não. A análise e a formatação rodam inteiramente no seu navegador, então dados push, tokens e conteúdos de conversa nunca saem da sua máquina.

Glossário

SSE
Server-Sent Events, um padrão para streaming push unidirecional do servidor ao cliente sobre HTTP.
text/event-stream
O tipo de mídia MIME do corpo de uma resposta SSE, que contém linhas de campos separadas por linhas em branco.
Bloco de evento
Um grupo de linhas de campo consecutivas e não vazias que juntas descrevem um evento enviado por push, finalizado por uma linha em branco.
Campo data
O campo SSE que carrega o payload do evento; várias linhas data em um mesmo evento são unidas com uma quebra de linha e costumam ser JSON.
Campo event
O campo opcional que nomeia o tipo de evento; quando ausente, o navegador o despacha como o evento genérico 'message'.
Campo id
O valor opcional de last-event-id usado para retomar um stream; este conversor emite ids numéricos como números JSON.
Campo retry
Um campo opcional que informa ao cliente o tempo de espera para reconexão em milissegundos; deve conter apenas dígitos ASCII.
Linha de comentário
Uma linha que começa com dois-pontos, usada muitas vezes como heartbeat ou keep-alive, e que é ignorada ao montar os eventos.

Authoritative References