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

  1. Incolla il flusso SSE grezzo nel textarea di sinistra, con le righe id/event/data e una riga vuota tra gli eventi
  2. La destra si aggiorna automaticamente e mostra un array JSON con un oggetto per ogni evento
  3. Controlla il pannello di avvisi se un payload di dati non è JSON valido o un campo sembra malformato
  4. 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.

StrumentoForma di inputPunto di forza principaleQuando usarlo
SSE in JSONBlocchi id/event/data separati da righe vuoteComprende i campi SSE e analizza ogni payload datiFlussi push del server, text/event-stream, frammenti in streaming dell'IA
Formattatore JSONLUn oggetto JSON completo per rigaConvalida e formatta ogni riga in modo indipendenteLog NDJSON, eventi archiviati, export delimitati da righe
Formattatore JSONUn oggetto o array JSON completoAbbellisce un unico documento JSON completoRisposte 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