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

Een gerichte converter voor pushgegevens van Server-Sent Events (SSE). Plak links de ruwe id-/event-/data-blokken en rechts verschijnt direct een standaard JSON-array, waarbij elke gepushte gebeurtenis één object wordt met zijn id, gebeurtenisnaam en geparste data-payload.

Gerelateerde aanbevelingen

Wat is SSE naar JSON-conversie?

Server-Sent Events (SSE) is een eenrichtingsprotocol voor streaming waarbij een server UTF-8-tekstgebeurtenissen schrijft over een HTTP-antwoord van het type `text/event-stream`. Op de draad is elke gebeurtenis een reeks veldregels zoals `id: 1`, `event: MESSAGE` en `data: {...}`, en een lege regel markeert het einde van die gebeurtenis.

Ruwe SSE is handig voor transport, maar lastig te lezen en te debuggen. Veldnamen herhalen zich bij elke gebeurtenis, de JSON-payload zit achter een `data:`-voorvoegsel, en lange stromen zakken in elkaar tot een muur tekst. SSE naar JSON converteren betekent elke gebeurtenis normaliseren tot een gewoon object en alle gebeurtenis verzamelen in één JSON-array.

Deze converter volgt de interpretatieregels van de event-stream: hij splitst op regeleinden, behandelt een lege regel als de dispatch-grens, verwijdert precies één optionele spatie na de veld-dubbele punt, voegt herhaalde data-regels samen met newlines en negeert met een dubbele punt voorziene commentaren. Daarna parsed hij elke data-payload als JSON zodat geneste structuren behouden blijven.

Het resultaat is een standaard, ingesprongen JSON-array die makkelijk leest, naar code te kopiëren, tegen een andere opname te diffen of in volgende tools te voeden, terwijl elke onparseerbare payload wordt gemarkeerd in plaats van weggegooid.

Toepassingsgevallen

  • Streaming-antwoorden van LLM- of AI-agents debuggen die binnenkomen als SSE-gebeurtenischunks zoals STREAM_CHUNK of CHUNK_DELTA
  • Een uit het tabblad Netwerk van de browser DevTools gekopieerd text/event-stream-antwoord omzetten in leesbare JSON
  • Heartbeat-, ack- en volledige-berichtgebeurtenissen van een realtime push- of chat-backend inspecteren
  • Vastgelegde SSE-pushgegevens omzetten in een JSON-array voordat je ze voor debugging deelt met een teamgenoot
  • De geneste data-payload van elke gebeurtenis extraheren en uitklappen zonder handmatig data:-voorvoegsels te verwijderen
  • Een opgenomen push-stream offline afspelen en de gebeurtenisvolgorde aan de hand van id vergelijken
  • SSE-gebeurtenisgegevens voorbereiden voor analyses, logs of spreadsheets die een JSON-array verwachten
  • Tijdens frontend-backend-integratie verifiëren of een server de verwachte gebeurtenisnamen en payload-vorm uitzendt
  • Meerregelige data-velden plat maken tot één geparste waarde per gebeurtenisobject
  • SSE-sporen van proxies, gateways of curl-uitvoer inspecteren in een gestructureerde, inklapvriendelijke vorm
  • Webhook-achtige of message-queue-gebeurtenisstromen die de SSE-draadindeling hergebruiken omzetten in JSON
  • De draadindeling van Server-Sent Events leren door te zien hoe id, event en data naar JSON-objecten worden afgebeeld

Hoe te gebruiken

  1. Plak de ruwe SSE-stream in de linker-textarea, met id-/event-/data-regels en een lege regel tussen de gebeurtenissen
  2. De rechterkant werkt automatisch bij en toont een JSON-array met één object per gebeurtenis
  3. Bekijk het waarschuwingsvenster als een data-payload geen geldige JSON is of een veld er misvormd uitziet
  4. Gebruik Kopiëren om de hele JSON-array te kopiëren, of Voorbeeld om eerst een ingebouwd voorbeeld te laden

Functies

  • Converteert een ruwe SSE-gebeurtenisstroom naar een standaard JSON-array, met één object per gepushte gebeurtenis
  • Groepeert regels tot gebeurtenis per lege regel en volgt daarmee het dispatchmodel van Server-Sent Events
  • Parsed elk veld als veld: waarde en verwijdert de enkele spatie na de dubbele punt
  • Parsed elke data-payload met JSON.parse, zodat geneste payloads echte objecten worden in plaats van ge-escapte strings
  • Houdt een stabiele sleutelvolgorde aan van id, event en data en zet numerieke ids om in JSON-getallen
  • Ondersteunt meerregelige data-velden, commentaarregels die met een dubbele punt beginnen en stromen zonder afsluitende lege regel
  • Meldt ongeldige data-payloads en onbekende of misvormde velden met blok- en regelnummers
  • Gesplitste lay-out van invoer-textarea en JSON-voorbeeld, met voorbeeld, wissen, kopiëren en gebeurtenisstatistiek; draait geheel in de browser

SSE naar JSON vs JSONL-formatter vs JSON-formatter

Deze tools gaan uit van verschillende invoervormen. De juiste kiezen voorkomt dat je handmatig voorvoegsels moet strippen en arrays moet inpakken.

ToolInvoervormKernvermogenWanneer gebruiken
SSE naar JSONid-/event-/data-blokken gesplitst door lege regelsBegrijpt SSE-velden en parsed elke data-payloadServer-push-stromen, text/event-stream, AI-streaming-chunks
JSONL-formatterEén compleet JSON-object per regelValideert en formatteert elke regel onafhankelijkNDJSON-logs, archiefgebeurtenissen, regelsgewijze exports
JSON-formatterEén compleet JSON-object of -arrayVerfraait één volledig JSON-documentAPI-antwoorden, configuratiebestanden, eenmalige payloads

Best Practices

Bewaar de lege regel tussen gebeurtenissen bij het kopiëren van een stream

De lege regel is wat de ene SSE-gebeurtenis van de volgende scheidt. Als je lege regels verwijdert tijdens het kopiëren, kunnen afzonderlijke gebeurtenissen samensmelten tot één blok en klopt de conversie niet langer met de oorspronkelijke dispatch-volgorde.

Gebruik de blok- en regelnummers in waarschuwingen om naar het probleem te springen

Als een data-payload niet lukt om te parsen, noemt de waarschuwing het gebeurtenisblok en de betreffende regel. Vergelijk dat blok met een naburig geldige gebeurtenis om een afgesloten haakje te herkennen, een ontbrekend aanhalingsteken of samengevoegde chunks.

Onthoud dat alleen het data-veld als JSON wordt geparst

De velden id, event en retry zijn SSE-transportmetadata en blijven scalair. Verwacht niet dat de converter JSON parsed die in de gebeurtenisnaam of id verschijnt; gestructureerde inhoud hoort in data.

Voeg gedeeltelijke streaming-chunks samen vóór het converteren van een volledig bericht

Veel AI-streams sturen veel kleine STREAM_CHUNK-gebeurtenissen die één bericht opbouwen. Converteer eerst de hele opname om elke chunk als array-item te zien, en voeg daarna de chunk-payloads samen in je applicatiecode als je het eindbericht nodig hebt.

Schoon gevoelige payloads op voordat je de geconverteerde JSON deelt

De conversie is lokaal, maar zodra je de JSON-array in een ticket of chat kopieert, verlaat hij je machine. Verwijder tokens, gebruikers-ids en privé-gesprekstekst uit de uitvoer voordat je deelt.

Veelgestelde vragen

Wat is SSE (Server-Sent Events)?

SSE is een standaardmanier waarmee een server tekstgebeurtenissen via HTTP naar een browser pusht met het content-type `text/event-stream`. Elke gebeurtenis bestaat uit tekstregels zoals `id`, `event` en `data`, en gebeurtenissen worden van elkaar gescheiden door een lege regel.

Hoe splitst dit hulpprogramma de stream in gebeurtenissen?

Het volgt het SSE-dispatchmodel: de invoer wordt in regels opgedeeld, opeenvolgende niet-lege regels vormen één gebeurtenisblok, en een lege regel verzendt dat blok als een nieuwe gebeurtenis. Een laatste blok zonder afsluitende lege regel wordt alsnog uitgegeven, en commentaarregels die met een dubbele punt beginnen worden genegeerd.

Hoe ziet de uitvoer-JSON eruit?

Het resultaat is één JSON-array. Elke invoergebeurtenis wordt één object met de aanwezige velden, in de stabiele volgorde id, event, data. De `data`-tekst wordt geparst met JSON.parse, zodat een payload als `data: {"a":1}` een genest object `"data": {"a":1}` wordt in plaats van een ge-escapte string.

Waarom is de id een getal in de uitvoer?

SSE-ids zijn technisch gezien strings, maar echte push-streams gebruiken bijna altijd numerieke ids zoals `id: 0`. Bestaat een id alleen uit cijfers, dan geeft de converter hem uit als JSON-getal; elke andere id blijft een string.

Wat gebeurt er als data over meerdere regels loopt?

Volgens de SSE-specificatie worden meerdere `data:`-regels binnen één gebeurtenis samengevoegd met een newline-teken voordat ze als één waarde worden geparst. Als de samengevoegde tekst geen geldige JSON is, behoudt de converter de ruwe tekst en voegt een waarschuwing toe, zodat er niets stilzwijgend verloren gaat.

Wat als een data-payload geen geldige JSON is?

In plaats van de hele conversie te laten mislukken, behoudt die gebeurtenis de ruwe data als JSON-string en toont de pagina een waarschuwing met het bloknummer en de parserfoutmelding. Rondom geldige gebeurtenissen worden gewoon normaal geconverteerd.

Wat is het verschil tussen SSE naar JSON en de JSONL-formatter?

JSONL heeft op elke regel één compleet JSON-object. SSE daarentegen heeft gelabelde `id/event/data`-regels die door lege regels tot gebeurtenissen worden gegroepeerd, en alleen het datagedeelte is JSON. SSE naar JSON begrijpt die veldlabels en de gebeurtenisgrenzen per lege regel, terwijl een JSONL-formatter elke regel onafhankelijk zou behandelen.

Uploadt deze converter mijn streamgegevens?

Nee. Parsen en formatteren draaien geheel in je browser, dus pushgegevens, tokens en gespreksinhoud verlaten nooit je machine.

Woordenlijst

SSE
Server-Sent Events, een standaard voor eenrichtings-pushstreaming van server naar client via HTTP.
text/event-stream
Het MIME-mediatype van een SSE-antwoordbody, dat veldregels bevat gescheiden door lege regels.
Gebeurtenisblok
Een groep opeenvolgende niet-lege veldregels die samen één gepushte gebeurtenis beschrijven, afgesloten door een lege regel.
data-veld
Het SSE-veld dat de gebeurtenis-payload draagt; meerdere data-regels in één gebeurtenis worden samengevoegd met een newline en zijn meestal JSON.
event-veld
Het optionele veld dat het type gebeurtenis benoemt; ontbreekt het, dan verzendt de browser het als de generieke 'message'-gebeurtenis.
id-veld
De optionele last-event-id-waarde die wordt gebruikt om een stream te hervatten; deze converter geeft numerieke ids uit als JSON-getallen.
retry-veld
Een optioneel veld dat de client de wachttijd voor herverbinding vertelt in milliseconden; het mag alleen ASCII-cijfers bevatten.
Commentaarregel
Een regel die begint met een dubbele punt, vaak gebruikt als heartbeat of keep-alive, die wordt genegeerd bij het opbouwen van gebeurtenissen.

Authoritative References