SSE in 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 convertitore mirato ai dati push di Server-Sent Events (SSE). Incolla a sinistra i blocchi grezzi id/event/data e a destra viene renderizzato all'istante un array JSON standard in cui ogni evento inviato diventa un unico oggetto con il suo id, il nome evento e il payload di dati analizzato.
Raccomandazioni correlate
Che cos'è la conversione di SSE in JSON?
I Server-Sent Events (SSE) sono un protocollo di streaming unidirezionale in cui un server scrive eventi di testo UTF-8 su una risposta HTTP di tipo `text/event-stream`. Sul cavo, ogni evento è una sequenza di righe di campo come `id: 1`, `event: MESSAGE` e `data: {...}`, e una riga vuota marca la fine di quell'evento.
L'SSE grezzo è comodo per il trasporto ma scomodo da leggere e debuggare. I nomi dei campi si ripetono su ogni evento, il payload JSON si trova dietro un prefisso `data:` e i flussi lunghi si compattano in un muro di testo. Convertire SSE in JSON significa normalizzare ogni evento in un oggetto semplice e raccogliere tutti gli eventi in un unico array JSON.
Questo convertitore segue le regole di interpretazione dell'event-stream: divide sui fine riga, tratta la riga vuota come confine di dispatch, rimuove esattamente uno spazio opzionale dopo i due punti del campo, unisce le righe dati ripetute con newline e ignora i commenti con prefisso due punti. Poi analizza ogni payload dati come JSON così le strutture annidate vengono preservate.
Il risultato è un array JSON standard e indentato, facile da leggere, copiare nel codice, confrontare con un'altra cattura tramite diff o alimentare strumenti a valle, mentre qualsiasi payload non analizzabile viene segnalato anziché scartato.
Casi d'uso
- Debuggare le risposte in streaming di LLM o agenti IA che arrivano come blocchi di eventi SSE come STREAM_CHUNK o CHUNK_DELTA
- Trasformare una risposta text/event-stream copiata dalla scheda Rete degli strumenti per sviluppatori del browser in JSON leggibile
- Ispezionare eventi di heartbeat, ack e messaggio completo da un backend di push in tempo reale o di chat
- Convertire i dati push SSE catturati in un array JSON prima di condividerli con un collega per il debug
- Estrarre ed espandere il payload dati annidato di ogni evento, senza rimuovere a mano i prefissi data:
- Riprodurre offline un flusso push registrato e confrontare l'ordine degli eventi per id
- Preparare i dati di eventi SSE per analisi, log o fogli di calcolo che si aspettano un array JSON
- Verificare che un server emetta i nomi evento e la forma del payload attesi durante l'integrazione frontend-backend
- Appiattire i campi dati multiriga in un unico valore analizzato per oggetto evento
- Ispezionare le tracce SSE provenienti da proxy, gateway o output di curl in una forma strutturata e facile da comprimere
- Convertire in JSON flussi di eventi stile Webhook o da code di messaggi che riutilizzano il formato di trasporto SSE
- Imparare il formato di trasporto dei Server-Sent Events vedendo come id, event e data mappano su oggetti JSON
Come utilizzare
- Incolla il flusso SSE grezzo nel textarea di sinistra, con le righe id/event/data e una riga vuota tra gli eventi
- La destra si aggiorna automaticamente e mostra un array JSON con un oggetto per ogni evento
- Controlla il pannello di avvisi se un payload di dati non è JSON valido o un campo sembra malformato
- Usa Copia per copiare l'intero array JSON, oppure Esempio per caricare prima un esempio integrato
Funzionalità
- Converte un flusso di eventi SSE grezzo in un array JSON standard, con un oggetto per ogni evento inviato
- Raggruppa le righe in eventi tramite la riga vuota, seguendo il modello di dispatch dei Server-Sent Events
- Analizza ogni campo come campo: valore e rimuove il singolo spazio dopo i due punti
- Analizza ogni payload di dati con JSON.parse così i payload annidati diventano oggetti reali, non stringhe escape
- Mantiene un ordine stabile delle chiavi id, event e data e trasforma gli id numerici in numeri JSON
- Supporta campi dati multiriga, righe di commento che iniziano con i due punti e flussi senza riga vuota finale
- Segnala i payload di dati non validi e i campi sconosciuti o malformati con numero di blocco e di riga
- Layout con textarea di input e anteprima JSON, con esempio, cancella, copia e statistiche sugli eventi; funziona interamente nel browser
SSE in JSON vs formattatore JSONL vs formattatore JSON
Questi strumenti gestiscono forme di input diverse. Scegliere quello giusto evita di rimuovere a mano i prefissi e di avvolgere array.
| Strumento | Forma di input | Punto di forza principale | Quando usarlo |
|---|---|---|---|
| SSE in JSON | Blocchi id/event/data separati da righe vuote | Comprende i campi SSE e analizza ogni payload dati | Flussi push del server, text/event-stream, frammenti in streaming dell'IA |
| Formattatore JSONL | Un oggetto JSON completo per riga | Convalida e formatta ogni riga in modo indipendente | Log NDJSON, eventi archiviati, export delimitati da righe |
| Formattatore JSON | Un oggetto o array JSON completo | Abbellisce un unico documento JSON completo | Risposte API, file di configurazione, payload singoli |
Best Practices
Mantieni la riga vuota tra gli eventi quando copi un flusso
La riga vuota è ciò che separa un evento SSE dal successivo. Se rimuovi le righe vuote durante la copia, eventi distinti possono fondersi in un unico blocco e la conversione non corrisponderà più all'ordine di dispatch originale.
Usa i numeri di blocco e di riga negli avvisi per saltare al problema
Quando un payload dati non viene analizzato, l'avviso indica il blocco evento e la riga colpevole. Confronta quel blocco con un evento valido vicino per individuare una parentesi graffa troncata, una virgoletta mancante o frammenti uniti.
Ricorda che solo il campo data viene analizzato come JSON
I campi id, event e retry sono metadati di trasporto SSE e restano valori scalari. Non aspettarti che il convertitore analizzi JSON che compare nel nome evento o nell'id; il contenuto strutturato appartiene a data.
Assembla i frammenti di streaming parziali prima di convertire un messaggio completo
Molti flussi IA inviano tanti piccoli eventi STREAM_CHUNK che compongono un unico messaggio. Converti prima l'intera cattura per vedere ogni frammento come un elemento di array, poi unisci i payload dei frammenti nel codice della tua applicazione se ti serve il messaggio finale.
Igienizza i payload sensibili prima di condividere il JSON convertito
La conversione è locale, ma una volta che copi l'array JSON in un ticket o in una chat, esce dalla tua macchina. Rimuovi token, id utente e testo privato della conversazione dall'output prima di condividerlo.
Domande frequenti
Che cos'è SSE (Server-Sent Events)?
SSE è un modo standard per un server di inviare eventi testuali a un browser su HTTP usando il tipo di contenuto `text/event-stream`. Ogni evento è composto da righe di testo come `id`, `event` e `data`, e gli eventi sono separati tra loro da una riga vuota.
Come divide questo strumento il flusso in eventi?
Segue il modello di dispatch SSE: l'input viene diviso in righe, le righe consecutive non vuote formano un blocco evento e una riga vuota effettua il dispatch di quel blocco come un nuovo evento. L'ultimo blocco senza riga vuota finale viene comunque emesso e le righe di commento che iniziano con i due punti vengono ignorate.
Che aspetto ha il JSON di output?
Il risultato è un unico array JSON. Ogni evento di input diventa un oggetto con i campi presenti, nell'ordine stabile id, event, data. Il testo `data` viene analizzato con JSON.parse, così un payload come `data: {"a":1}` diventa un oggetto annidato `"data": {"a":1}` invece di una stringa escape.
Perché l'id nell'output è un numero?
Tecnicamente gli id SSE sono stringhe, ma i flussi push reali usano quasi sempre id numerici come `id: 0`. Quando un id è composto solo da cifre, il convertitore lo emette come numero JSON; qualsiasi altro id viene mantenuto come stringa.
Cosa succede quando i dati occupano più righe?
Secondo la specifica SSE, più righe `data:` all'interno di un unico evento vengono unite con un carattere di newline prima di essere analizzate come un unico valore. Se il testo unito non è JSON valido, il convertitore mantiene il testo grezzo e aggiunge un avviso così nulla viene perso silenziosamente.
Cosa succede se un payload di dati non è JSON valido?
Invece di far fallire l'intera conversione, quell'evento mantiene i dati grezzi come stringa JSON e la pagina mostra un avviso con il numero di blocco e il messaggio di errore del parser. Gli eventi validi intorno vengono comunque convertiti normalmente.
Che differenza c'è tra SSE in JSON e il formattatore JSONL?
JSONL ha un oggetto JSON completo su ogni riga. SSE ha invece righe etichettate `id/event/data` raggruppate in eventi da righe vuote, e solo la parte dati è JSON. SSE in JSON capisce quelle etichette di campo e i confini di evento da riga vuota, mentre un formattatore JSONL tratterebbe ogni riga in modo indipendente.
Questo convertitore carica i dati del mio flusso?
No. L'analisi e la formattazione avvengono interamente nel tuo browser, quindi i dati push, i token e il contenuto delle conversazioni non lasciano mai la tua macchina.
Glossario
- SSE
- Server-Sent Events, uno standard per lo streaming push unidirezionale da server a client su HTTP.
- text/event-stream
- Il tipo MIME del corpo di una risposta SSE, che contiene righe di campo separate da righe vuote.
- Blocco evento
- Un gruppo di righe di campo consecutive e non vuote che descrivono insieme un evento inviato, terminato da una riga vuota.
- campo data
- Il campo SSE che trasporta il payload dell'evento; più righe data in un unico evento vengono unite con un newline e di solito sono JSON.
- campo event
- Il campo opzionale che nomina il tipo di evento; quando assente il browser lo invia come l'evento generico 'message'.
- campo id
- Il valore opzionale last-event-id usato per riprendere un flusso; questo convertitore emette gli id numerici come numeri JSON.
- campo retry
- Un campo opzionale che indica al client l'attesa di riconnessione in millisecondi; deve contenere solo cifre ASCII.
- Riga di commento
- Una riga che inizia con i due punti, spesso usata come heartbeat o keep-alive, che viene ignorata durante la costruzione degli eventi.
Authoritative References
- MDN Web DocsMDN: Server-sent events
- HTML Living StandardWHATWG: Server-sent events (formato event stream)
- Compressione JSON
- CSV in JSON
- JSON to CSV
- JSON Diff
- JSON Escape / Unescape
- Appiattimento JSON
- Formattatore JSON
- Formattatore JSONL
- SSE in JSON
- Generatore JSON
- Query JSONPath
- Unire JSON
- Riparare JSON
- Validatore di Schema JSON
- Ordinare JSON
- JSON Stringify
- JSON in HTML
- JSON in Java
- JSON to Markdown
- JSON in SQL
- JSON in TOML
- JSON in TypeScript
- XML in JSON
- JSON in XML
- YAML in JSON
- Da JSON a YAML
- JSON in Python
- JSON in Go
- JSON in Rust
- JSON in Swift
- JSON a C#
- JSON a C++
- JSON to PHP