SSE a 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

Un convertidor centrado en los datos push de Server-Sent Events (SSE). Pega a la izquierda los bloques crudos id/event/data y la derecha renderiza al instante un array JSON estándar donde cada evento enviado se convierte en un único objeto con su id, el nombre de evento y la carga de datos analizada.

Relacionado

¿Qué es la conversión de SSE a JSON?

Server-Sent Events (SSE) es un protocolo de streaming unidireccional en el que un servidor escribe eventos de texto UTF-8 sobre una respuesta HTTP de tipo `text/event-stream`. En el cable, cada evento es una secuencia de líneas de campo como `id: 1`, `event: MESSAGE` y `data: {...}`, y una línea en blanco marca el fin de ese evento.

El SSE en bruto es cómodo para el transporte pero incómodo de leer y depurar. Los nombres de campo se repiten en cada evento, la carga JSON queda detrás de un prefijo `data:` y los flujos largos se convierten en un muro de texto. Convertir SSE a JSON significa normalizar cada evento en un objeto plano y recoger todos los eventos en un único array JSON.

Este convertidor sigue las reglas de interpretación de event-stream: divide según los finales de línea, trata la línea en blanco como límite de distribución, elimina exactamente un espacio opcional después de los dos puntos del campo, une las líneas de datos repetidas con saltos de línea e ignora los comentarios que empiezan por dos puntos. Luego analiza cada carga de datos como JSON de modo que las estructuras anidadas se conservan.

El resultado es un array JSON estándar e indentado, fácil de leer, copiar al código, comparar con otra captura mediante diff o alimentar herramientas posteriores, mientras que cualquier carga que no se pueda analizar se señala en lugar de descartarse.

Casos de uso

  • Depurar respuestas en flujo de modelos de lenguaje o agentes de IA que llegan como fragmentos de eventos SSE como STREAM_CHUNK o CHUNK_DELTA
  • Convertir una respuesta text/event-stream copiada de la pestaña Red de las herramientas para desarrolladores del navegador en JSON legible
  • Inspeccionar eventos de heartbeat, ack y mensaje completo desde un backend de push en tiempo real o de chat
  • Convertir datos push SSE capturados en un array JSON antes de compartirlos con un compañero para depurar
  • Extraer y expandir la carga de datos anidada de cada evento, sin tener que eliminar manualmente los prefijos data:
  • Reproducir sin conexión un flujo de push grabado y comparar el orden de los eventos por id
  • Preparar datos de eventos SSE para análisis, logs u hojas de cálculo que esperan un array JSON
  • Verificar que un servidor emite los nombres de evento y la forma de carga esperados durante la integración frontend-backend
  • Aplanar los campos de datos multilínea en un único valor analizado por objeto de evento
  • Inspeccionar trazas SSE provenientes de proxies, pasarelas o salida de curl de forma estructurada y fácil de plegar
  • Convertir a JSON flujos de eventos tipo Webhook o de cola de mensajes que reutilizan el formato de transmisión SSE
  • Aprender el formato de transmisión de Server-Sent Events viendo cómo id, event y data se asignan a objetos JSON

Cómo Usar

  1. Pega el flujo SSE en bruto en el textarea de la izquierda, con las líneas id/event/data y una línea en blanco entre eventos
  2. La derecha se actualiza automáticamente y muestra un array JSON con un objeto por cada evento
  3. Revisa el panel de avisos si alguna carga de datos no es JSON válido o algún campo parece mal formado
  4. Usa Copiar para copiar todo el array JSON, o Muestra para cargar antes un ejemplo integrado

Características

  • Convierte un flujo de eventos SSE en bruto en un array JSON estándar, con un objeto por cada evento enviado
  • Agrupa las líneas en eventos mediante la línea en blanco, siguiendo el modelo de distribución de Server-Sent Events
  • Analiza cada campo como campo: valor y elimina el espacio simple que va después de los dos puntos
  • Analiza cada carga de datos con JSON.parse para que las cargas anidadas se conviertan en objetos reales, no en cadenas escapadas
  • Mantiene un orden estable de claves id, event y data, y convierte los id numéricos en números JSON
  • Admite campos de datos multilínea, líneas de comentario que empiezan por dos puntos y flujos sin línea en blanco final
  • Informa de las cargas de datos no válidas y de los campos desconocidos o mal formados con el número de bloque y de línea
  • Diseño con textarea de entrada y vista previa JSON, con muestra, borrar, copiar y estadísticas de eventos; se ejecuta por completo en el navegador

SSE a JSON frente a formateador JSONL y formateador JSON

Estas herramientas manejan formas de entrada distintas. Elegir la correcta evita tener que quitar manualmente prefijos y envolver arrays.

HerramientaForma de entradaFortaleza principalCuándo usarla
SSE a JSONBloques id/event/data separados por líneas en blancoEntiende los campos SSE y analiza cada carga de datosFlujos push del servidor, text/event-stream, fragmentos en streaming de IA
Formateador JSONLUn objeto JSON completo por líneaValida y formatea cada línea de forma independienteLogs NDJSON, eventos archivados, exportaciones delimitadas por líneas
Formateador JSONUn objeto o array JSON completoEmbellece un único documento JSON completoRespuestas de API, archivos de configuración, payloads puntuales

Best Practices

Mantén la línea en blanco entre eventos al copiar un flujo

La línea en blanco es lo que separa un evento SSE del siguiente. Si quitas las líneas en blanco al copiar, los eventos distintos pueden fusionarse en un solo bloque y la conversión ya no coincidirá con el orden de distribución original.

Usa los números de bloque y de línea de los avisos para saltar al problema

Cuando una carga de datos falla al analizarse, el aviso indica el bloque de evento y la línea infractora. Compara ese bloque con un evento válido cercano para dar con una llave truncada, una comilla que falta o fragmentos unidos.

Recuerda que solo el campo data se analiza como JSON

Los campos id, event y retry son metadatos de transporte SSE y se mantienen como valores escalares. No esperes que el convertidor analice JSON que aparezca dentro del nombre de evento o del id; el contenido estructurado pertenece a data.

Reúne los fragmentos en streaming parciales antes de convertir un mensaje completo

Muchos flujos de IA envían muchos eventos pequeños STREAM_CHUNK que construyen un único mensaje. Primero convierte toda la captura para ver cada fragmento como un elemento de array, y luego fusiona las cargas de los fragmentos en el código de tu aplicación si necesitas el mensaje final.

Desinfecta las cargas sensibles antes de compartir el JSON convertido

La conversión es local, pero una vez copias el array JSON en un ticket o un chat, sale de tu máquina. Elimina los tokens, los id de usuario y el texto privado de la conversación de la salida antes de compartirla.

Preguntas Frecuentes

¿Qué es SSE (Server-Sent Events)?

SSE es una forma estándar que tiene un servidor de enviar eventos de texto a un navegador por HTTP mediante el tipo de contenido `text/event-stream`. Cada evento se compone de líneas de texto como `id`, `event` y `data`, y los eventos se separan entre sí mediante una línea en blanco.

¿Cómo divide esta herramienta el flujo en eventos?

Sigue el modelo de distribución SSE: la entrada se divide en líneas, las líneas consecutivas no vacías forman un bloque de evento, y una línea en blanco distribuye ese bloque como un nuevo evento. El bloque final sin línea en blanco final igualmente se emite, y las líneas de comentario que empiezan por dos puntos se ignoran.

¿Qué aspecto tiene el JSON de salida?

El resultado es un único array JSON. Cada evento de entrada se convierte en un objeto con los campos presentes, en el orden estable id, event, data. El texto `data` se analiza con JSON.parse, de modo que una carga como `data: {"a":1}` se convierte en un objeto anidado `"data": {"a":1}` en lugar de una cadena escapada.

¿Por qué el id sale como un número en la salida?

Técnicamente los id SSE son cadenas, pero los flujos push reales casi siempre usan id numéricos como `id: 0`. Cuando un id se compone solo de dígitos, el convertidor lo emite como un número JSON; cualquier otro id se mantiene como cadena.

¿Qué ocurre cuando los datos ocupan varias líneas?

Según la especificación SSE, varias líneas `data:` dentro de un mismo evento se unen con un salto de línea antes de analizarse como un único valor. Si el texto unido no es JSON válido, el convertidor conserva el texto en bruto y añade un aviso para que no se pierda nada de forma silenciosa.

¿Qué pasa si una carga de datos no es JSON válido?

En lugar de hacer fallar toda la conversión, ese evento conserva los datos en bruto como una cadena JSON y la página muestra un aviso con el número de bloque y el mensaje de error del analizador. Los eventos válidos de alrededor se convierten con normalidad.

¿Qué diferencia hay entre SSE a JSON y el formateador JSONL?

JSONL tiene un objeto JSON completo en cada línea. En cambio, SSE tiene líneas etiquetadas `id/event/data` agrupadas en eventos mediante líneas en blanco, y solo la parte de datos es JSON. SSE a JSON entiende esas etiquetas de campo y los límites de evento por línea en blanco, mientras que un formateador JSONL trataría cada línea de forma independiente.

¿Este convertidor sube los datos de mi flujo?

No. El análisis y el formateo se ejecutan por completo en tu navegador, de modo que los datos push, los tokens y el contenido de las conversiones nunca salen de tu máquina.

Glosario

SSE
Server-Sent Events, un estándar para el streaming push unidireccional de servidor a cliente por HTTP.
text/event-stream
El tipo MIME del cuerpo de una respuesta SSE, que contiene líneas de campo separadas por líneas en blanco.
Bloque de evento
Un grupo de líneas de campo consecutivas y no vacías que describen en conjunto un evento enviado, finalizado por una línea en blanco.
campo data
El campo SSE que transporta la carga del evento; varias líneas data en un mismo evento se unen con un salto de línea y suelen ser JSON.
campo event
El campo opcional que nombra el tipo de evento; cuando falta, el navegador lo distribuye como el evento genérico «message».
campo id
El valor opcional last-event-id usado para reanudar un flujo; este convertidor emite los id numéricos como números JSON.
campo retry
Un campo opcional que indica al cliente la espera de reconexión en milisegundos; debe contener solo dígitos ASCII.
Línea de comentario
Una línea que empieza por dos puntos, usada a menudo como heartbeat o keep-alive, que se ignora al construir los eventos.

Authoritative References