SSE a JSON
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.
Un convertidor centrat en les dades push de Server-Sent Events (SSE). Enganxa a l'esquerra els blocs crus id/event/data i a la dreta es renderitza de manera immediata un array JSON estàndard on cada esdeveniment enviat esdevé un objecte únic amb el seu id, el nom d'esdeveniment i la càrrega de dades analitzada.
Relacionats
Què és la conversió de SSE a JSON?
Server-Sent Events (SSE) és un protocol de streaming unidireccional en què un servidor escriu esdeveniments de text UTF-8 sobre una resposta HTTP de tipus `text/event-stream`. Al canal, cada esdeveniment és una seqüència de línies de camp com ara `id: 1`, `event: MESSAGE` i `data: {...}`, i una línia en blanc marca el final d'aquest esdeveniment.
El SSE cru és convenient per al transport però incòmode de llegir i depurar. Els noms de camp es repeteixen a cada esdeveniment, la càrrega JSON queda darrere d'un prefix `data:` i els fluxos llargs es fonen en un mur de text. Convertir SSE a JSON significa normalitzar cada esdeveniment en un objecte pla i recollir tots els esdeveniments en un únic array JSON.
Aquest convertidor segueix les regles d'interpretació d'event-stream: divideix segons els finals de línia, tracta la línia en blanc com a límit de distribució, elimina exactament un espai opcional després dels dos punts del camp, uneix les línies de dades repetides amb salts de línia i ignora els comentaris que comencen per dos punts. Després analitza cada càrrega de dades com a JSON de manera que les estructures niades es conserven.
El resultat és un array JSON estàndard i indentat, fàcil de llegir, de copiar al codi, de comparar amb una altra captura amb diff o d'alimentar eines posteriors, mentre que qualsevol càrrega que no es pugui analitzar s'assenyala en lloc de descartar-se.
Casos d'ús
- Depurar respostes en flux de models de llenguatge o agents d'IA que arriben com a fragments d'esdeveniments SSE com STREAM_CHUNK o CHUNK_DELTA
- Convertir una resposta text/event-stream copiada de la pestanya Xarxa de les eines per a desenvolupadors del navegador en JSON llegible
- Inspeccionar esdeveniments de heartbeat, ack i missatge complet des d'un backend de push en temps real o de xat
- Convertir dades push SSE capturades en un array JSON abans de compartir-les amb un company per depurar
- Extreure i expandir la càrrega de dades niada de cada esdeveniment, sense haver d'eliminar manualment els prefixos data:
- Reproduir sense connexió un flux de push enregistrat i comparar l'ordre dels esdeveniments per id
- Preparar dades d'esdeveniments SSE per a anàlisi, logs o fulls de càlcul que esperen un array JSON
- Verificar que un servidor emet els noms d'esdeveniment i la forma de càrrega esperats durant la integració frontend-backend
- Aplanar els camps de dades multilínia en un únic valor analitzat per objecte d'esdeveniment
- Inspeccionar traçes SSE provinents de proxies, passarel·les o sortida de curl d'una forma estructurada i fàcil de plegar
- Convertir en JSON fluxos d'esdeveniments tipus Webhook o de cua de missatges que reutilitzen el format de transmissió SSE
- Aprendre el format de transmissió de Server-Sent Events veient com id, event i data es mapen a objectes JSON
Com usar-ho
- Enganxa el flux SSE cru al textarea de l'esquerra, amb les línies id/event/data i una línia en blanc entre esdeveniments
- La dreta s'actualitza automàticament i mostra un array JSON amb un objecte per cada esdeveniment
- Revisa el tauler d'avisos si alguna càrrega de dades no és JSON vàlid o algun camp sembla mal format
- Usa Copia per copiar tot l'array JSON, o Mostra per carregar abans un exemple integrat
Característiques
- Converteix un flux d'esdeveniments SSE cru en un array JSON estàndard, amb un objecte per cada esdeveniment enviat
- Agrupa les línies en esdeveniments mitjançant la línia en blanc, seguint el model de distribució de Server-Sent Events
- Analitza cada camp com a camp: valor i elimina l'espai simple que hi ha després dels dos punts
- Analitza cada càrrega de dades amb JSON.parse de manera que les càrregues niades esdevenen objectes reals, no cadenes escapades
- Manté un ordre estable de claus id, event i data, i converteix els id numèrics en nombres JSON
- Admet camps de dades multilínia, línies de comentari que comencen per dos punts i fluxos sense línia en blanc final
- Informa de les càrregues de dades no vàlides i dels camps desconeguts o mal formats amb el número de bloc i de línia
- Disseny amb textarea d'entrada i vista prèvia JSON, amb mostra, esborra, còpia i estadístiques d'esdeveniments; s'executa completament al navegador
SSE a JSON vs formatador JSONL vs formatador JSON
Aquestes eines gestionen formes d'entrada diferents. Triar la correcta evita haver d'eliminar manualment prefixos i embolicar arrays.
| Eina | Forma d'entrada | Fortalesa principal | Quan usar-la |
|---|---|---|---|
| SSE a JSON | Blocs id/event/data separats per línies en blanc | Entén els camps SSE i analitza cada càrrega de dades | Fluxos push del servidor, text/event-stream, fragments en streaming d'IA |
| Formatador JSONL | Un objecte JSON complet per línia | Valida i formata cada línia de manera independent | Logs NDJSON, esdeveniments arxivats, exportacions per línies |
| Formatador JSON | Un objecte o array JSON complet | Embelliex un únic document JSON sencer | Respostes d'API, fitxers de configuració, payloads puntuals |
Best Practices
Mantén la línia en blanc entre esdeveniments en copiar un flux
La línia en blanc és el que separa un esdeveniment SSE del següent. Si elimines les línies en blanc en copiar, esdeveniments distints poden fusionar-se en un sol bloc i la conversió ja no coincidirà amb l'ordre de distribució original.
Usa els números de bloc i de línia dels avisos per anar al problema
Quan una càrrega de dades no s'analitza, l'avís indica el bloc d'esdeveniment i la línia infractor. Compara aquell bloc amb un esdeveniment vàlid proper per localitzar una claudàtor truncada, una cometa que falta o fragments units.
Recorda que només el camp data s'analitza com a JSON
Els camps id, event i retry són metadades de transport SSE i es mantenen com a valors escalars. No esperis que el convertidor analitzi JSON que apareix dins del nom d'esdeveniment o de l'id; el contingut estructurat va a data.
Reuneix els fragments en streaming parcials abans de convertir un missatge complet
Molts fluxos d'IA envien molts esdeveniments petits STREAM_CHUNK que construeixen un sol missatge. Primer converteix tota la captura per veure cada fragment com un element d'array, i després fusiona les càrregues dels fragments al codi de la teva aplicació si necessites el missatge final.
Neteja les càrregues sensibles abans de compartir el JSON convertit
La conversió és local, però un cop copies l'array JSON en un tiquet o un xat, aquest surt de la teva màquina. Elimina els testimonis, els id d'usuari i el text privat de la conversa de la sortida abans de compartir-la.
Preguntes freqients
Què és SSE (Server-Sent Events)?
SSE és una manera estàndard que té un servidor d'enviar esdeveniments de text a un navegador per HTTP mitjançant el tipus de contingut `text/event-stream`. Cada esdeveniment es compon de línies de text com ara `id`, `event` i `data`, i els esdeveniments se separen entre si per una línia en blanc.
Com divideix aquesta eina el flux en esdeveniments?
Segueix el model de distribució SSE: l'entrada es divideix en línies, les línies consecutives no buides formen un bloc d'esdeveniment, i una línia en blanc distribueix aquest bloc com un nou esdeveniment. El bloc final sense línia en blanc final igualment s'emet, i les línies de comentari que comencen per dos punts s'ignoren.
Quin aspecte té el JSON de sortida?
El resultat és un únic array JSON. Cada esdeveniment d'entrada esdevé un objecte amb els camps presents, en l'ordre estable id, event, data. El text `data` s'analitza amb JSON.parse, de manera que una càrrega com `data: {"a":1}` esdevé un objecte niat `"data": {"a":1}` en lloc d'una cadena escapada.
Per què l'id surt com un número a la sortida?
Tècnicament els id SSE són cadenes, però els fluxos push reals gairebé sempre usen id numèrics com `id: 0`. Quan un id es compon només de dígits, el convertidor l'emet com un número JSON; qualsevol altre id es manté com a cadena.
Què passa si les dades ocupen diverses línies?
Segons l'especificació SSE, diverses línies `data:` dins d'un mateix esdeveniment s'uneixen amb un salt de línia abans d'analitzar-se com un sol valor. Si el text unit no és JSON vàlid, el convertidor conserva el text cru i afegeix un avís perquè no es perdi res de manera silenciosa.
Què passa si una càrrega de dades no és JSON vàlid?
En lloc de fer fallar tota la conversió, aquell esdeveniment conserva les dades crues com una cadena JSON i la pàgina mostra un avís amb el número de bloc i el missatge d'error de l'analitzador. Els esdeveniments vàlids del voltant es convergeixen amb normalitat.
Quina diferència hi ha entre SSE a JSON i el formatador JSONL?
JSONL té un objecte JSON complet per cada línia. En canvi, SSE té línies etiquetades `id/event/data` agrupades en esdeveniments per línies en blanc, i només la part de dades és JSON. SSE a JSON entén aquestes etiquetes de camp i els límits d'esdeveniment per línia en blanc, mentre que un formatador JSONL tractaria cada línia de manera independent.
Aquest convertidor puig les dades del meu flux?
No. L'anàlisi i el formatat s'executen completament al teu navegador, de manera que les dades push, els testimonis i el contingut de les converses no surten mai de la teva màquina.
Glossari
- SSE
- Server-Sent Events, un estàndard per al streaming push unidireccional de servidor a client per HTTP.
- text/event-stream
- El tipus MIME del cos d'una resposta SSE, que conté línies de camp separades per línies en blanc.
- Bloc d'esdeveniment
- Un grup de línies de camp consecutives i no buides que descriuen conjuntament un esdeveniment enviat, finalitzat per una línia en blanc.
- camp data
- El camp SSE que transporta la càrrega de l'esdeveniment; diverses línies data en un mateix esdeveniment s'uneixen amb un salt de línia i solen ser JSON.
- camp event
- El camp opcional que assigna un nom al tipus d'esdeveniment; quan no hi és, el navegador el distribueix com l'esdeveniment genèric «message».
- camp id
- El valor opcional last-event-id usat per reprendre un flux; aquest convertidor emet els id numèrics com a nombres JSON.
- camp retry
- Un camp opcional que indica al client l'espera de reconnectió en mil·lisegons; ha de contenir només dígits ASCII.
- Línia de comentari
- Una línia que comença per dos punts, sovint usada com a heartbeat o keep-alive, que s'ignora en construir els esdeveniments.
Authoritative References
- MDN Web DocsMDN: Server-sent events
- HTML Living StandardWHATWG: Server-sent events (format d'event stream)
- Comprimir JSON
- CSV a JSON
- JSON a CSV
- JSON Diff
- JSON Escape / Unescape
- Aplanar JSON
- JSON Formatter
- Formatador JSONL
- SSE a JSON
- Generador de JSON
- Consulta JSONPath
- Combinar JSON
- Reparació JSON
- Validador d'Esquema JSON
- Ordenar JSON
- JSON Stringify
- JSON a HTML
- JSON a Java
- JSON a Markdown
- JSON a SQL
- JSON a TOML
- JSON a TypeScript
- XML a JSON
- Converteix JSON a XML
- YAML a JSON
- JSON → YAML
- JSON a Python
- JSON a Go
- JSON a Rust
- JSON a Swift
- JSON a C#
- JSON a C++
- JSON a PHP