SSE zu 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.
Ein fokussierter Konverter für Push-Daten aus Server-Sent Events (SSE). Füge links die rohen id-/event-/data-Blöcke ein, und rechts rendert sich sofort ein Standard-JSON-Array, in das jedes Push-Ereignis zu einem einzelnen Objekt mit seiner id, seinem Ereignisnamen und dem geparsten Daten-Payload wird.
Ähnliche Tools
Was ist die Umwandlung von SSE in JSON?
Server-Sent Events (SSE) ist ein unidirektionales Streaming-Protokoll, bei dem ein Server UTF-8-Textereignisse über eine HTTP-Antwort vom Typ `text/event-stream` schreibt. Auf der Leitung ist jedes Ereignis eine Abfolge von Feldzeilen wie `id: 1`, `event: MESSAGE` und `data: {...}`, und eine Leerzeile markiert das Ende dieses Ereignisses.
Roh-SSE ist für den Transport praktisch, aber unhandlich zu lesen und zu debuggen. Feldnamen wiederholen sich bei jedem Ereignis, der JSON-Payload steckt hinter einem `data:`-Präfix, und lange Streams kollabieren zu einer Textwand. SSE in JSON umzuwandeln bedeutet, jedes Ereignis in ein schlichtes Objekt zu normalisieren und alle Ereignisse in einem JSON-Array zu sammeln.
Dieser Konverter folgt den Interpretationsregeln von Event-Streams: Er zerlegt am Zeilenende, behandelt eine Leerzeile als Dispatch-Grenze, entfernt genau ein optionales Leerzeichen nach dem Feld-Doppelpunkt, verbindet wiederholte data-Zeilen mit Zeilenumbrüchen und ignoriert mit einem Doppelpunkt beginnende Kommentare. Anschließend parst er jeden data-Payload als JSON, sodass verschachtelte Strukturen erhalten bleiben.
Das Ergebnis ist ein Standard-JSON-Array mit Einrückung, das sich leicht lesen, in Code kopieren, gegen eine andere Aufnahme abgleichen oder an nachgelagerte Tools weiterreichen lässt, während jeder nicht parsebare Payload markiert statt verworfen wird.
Anwendungsfälle
- Streaming-Antworten von LLM- oder KI-Agenten debuggen, die als SSE-Ereignis-Chunks wie STREAM_CHUNK oder CHUNK_DELTA eintreffen
- Eine aus dem Netzwerktab der Browser-Entwicklertools kopierte text/event-stream-Antwort in lesbares JSON verwandeln
- Heartbeat-, Ack- und Vollnachrichtenereignisse eines Echtzeit-Push- oder Chat-Backends untersuchen
- Erfasste SSE-Push-Daten vor dem Weitergeben an einen Kollegen zum Debuggen in ein JSON-Array umwandeln
- Den verschachtelten data-Payload jedes Ereignisses extrahieren und ausklappen, ohne data:-Präfixe manuell zu entfernen
- Einen aufgezeichneten Push-Stream offline abspielen und die Ereignisreihenfolge anhand der id vergleichen
- SSE-Ereignisdaten für Auswertungen, Protokolle oder Tabellen vorbereiten, die ein JSON-Array erwarten
- Bei der Frontend-Backend-Integration prüfen, ob der Server die erwarteten Ereignisnamen und Payload-Struktur sendet
- Mehrzeilige data-Felder zu einem einzigen geparsten Wert je Ereignisobjekt zusammenführen
- SSE-Spuren von Proxys, Gateways oder curl-Ausgabe in strukturierter, aufklappbarer Form untersuchen
- Webhook-artige oder Message-Queue-Ereignisströme, die das SSE-Drahtformat wiederverwenden, in JSON umwandeln
- Das Drahtformat von Server-Sent Events kennenlernen, indem man sieht, wie id, event und data auf JSON-Objekte abgebildet werden
Anleitung
- Füge den rohen SSE-Stream in die linke Textarea ein, mit id-/event-/data-Zeilen und je einer Leerzeile zwischen den Ereignissen
- Die rechte Seite aktualisiert sich automatisch und zeigt ein JSON-Array mit einem Objekt je Ereignis
- Prüfe das Warnfeld, falls ein data-Payload kein gültiges JSON ist oder ein Feld fehlerhaft wirkt
- Nutze Kopieren, um das gesamte JSON-Array zu übernehmen, oder Beispiel, um zuerst ein eingebautes Beispiel zu laden
Funktionen
- Wandelt einen rohen SSE-Ereignisstream in ein Standard-JSON-Array um – ein Objekt je Push-Ereignis
- Gruppiert Zeilen nach Leerzeilen zu Ereignissen und folgt damit dem Dispatch-Modell von Server-Sent Events
- Parst jedes Feld als Feld: Wert und entfernt das einzelne Leerzeichen nach dem Doppelpunkt
- Parst jeden data-Payload per JSON.parse, sodass verschachtelte Payloads echte Objekte werden statt escapte Strings
- Hält eine stabile Schlüsselreihenfolge aus id, event und data und wandelt numerische ids in JSON-Zahlen um
- Unterstützt mehrzeilige data-Felder, mit einem Doppelpunkt beginnende Kommentarzeilen und Streams ohne abschließende Leerzeile
- Meldet ungültige data-Payloads sowie unbekannte oder fehlerhafte Felder mit Block- und Zeilennummer
- Geteiltes Layout aus Eingabe-Textarea und JSON-Vorschau mit Beispiel, Leeren, Kopieren und Ereignisstatistik; läuft vollständig im Browser
SSE zu JSON vs. JSONL-Formatierung vs. JSON-Formatierung
Diese Werkzeuge verarbeiten unterschiedliche Eingabeformen. Das richtige zu wählen erspart das manuelle Entfernen von Präfixen und das Einschließen von Arrays.
| Werkzeug | Eingabeform | Kernfähigkeit | Einsatzszenario |
|---|---|---|---|
| SSE zu JSON | id-/event-/data-Blöcke, getrennt durch Leerzeilen | Versteht SSE-Felder und parst jeden data-Payload | Server-Push-Streams, text/event-stream, KI-Streaming-Chunks |
| JSONL-Formatierung | Ein vollständiges JSON-Objekt pro Zeile | Prüft und formatiert jede Zeile unabhängig | NDJSON-Protokolle, Archivereignisse, zeilengetrennte Exporte |
| JSON-Formatierung | Ein vollständiges JSON-Objekt oder -Array | Verschönert ein einzelnes vollständiges JSON-Dokument | API-Antworten, Konfigurationsdateien, einmalige Payloads |
Best Practices
Beim Kopieren eines Streams die Leerzeile zwischen den Ereignissen behalten
Die Leerzeile ist das, was ein SSE-Ereignis vom nächsten trennt. Entfernst du beim Kopieren Leerzeilen, können einzelne Ereignisse zu einem Block verschmelzen, und die Umwandlung stimmt nicht mehr mit der ursprünglichen Dispatch-Reihenfolge überein.
Die Block- und Zeilennummern in den Warnungen nutzen, um direkt zum Problem zu springen
Wenn ein data-Payload nicht geparst werden kann, nennt die Warnung den Ereignisblock und die betroffene Zeile. Vergleiche diesen Block mit einem benachbarten gültigen Ereignis, um eine abgeschnittene Klammer, ein fehlendes Anführungszeichen oder zusammengefügte Chunks zu erkennen.
Bedenke, dass nur das data-Feld als JSON geparst wird
Die Felder id, event und retry sind SSE-Transport-Metadaten und bleiben skalar. Erwarte nicht, dass der Konverter JSON parst, das im Ereignisnamen oder in der id auftaucht; strukturierte Inhalte gehören in data.
Partielle Streaming-Chunks erst zusammensetzen, bevor eine vollständige Nachricht umgewandelt wird
Viele KI-Streams senden viele kleine STREAM_CHUNK-Ereignisse, die eine Nachricht aufbauen. Wandle zuerst die gesamte Aufnahme um, um jeden Chunk als Array-Eintrag zu sehen, und führe die Chunk-Payloads dann in deinem Anwendungscode zusammen, falls du die endgültige Nachricht brauchst.
Empfindliche Payloads vor dem Teilen des umgewandelten JSON bereinigen
Die Umwandlung läuft lokal, aber sobald du das JSON-Array in ein Ticket oder einen Chat kopierst, verlässt es deinen Rechner. Entferne Tokens, Benutzer-ids und private Gesprächstexte aus der Ausgabe, bevor du sie teilst.
Häufig gestellte Fragen
Was ist SSE (Server-Sent Events)?
SSE ist ein Standardverfahren, mit dem ein Server Textereignisse über HTTP an einen Browser pusht, wobei der Content-Type `text/event-stream` verwendet wird. Jedes Ereignis besteht aus Textzeilen wie `id`, `event` und `data`, und die Ereignisse werden durch eine Leerzeile voneinander getrennt.
Wie teilt dieses Werkzeug den Stream in Ereignisse auf?
Es folgt dem SSE-Dispatch-Modell: Die Eingabe wird in Zeilen zerlegt, aufeinanderfolgende nicht-leere Zeilen bilden einen Ereignisblock, und eine Leerzeile versendet diesen Block als neues Ereignis. Ein letzter Block ohne abschließende Leerzeile wird trotzdem ausgegeben, und mit einem Doppelpunkt beginnende Kommentarzeilen werden ignoriert.
Wie sieht das Ausgabe-JSON aus?
Das Ergebnis ist ein einzelnes JSON-Array. Jedes Eingabeereignis wird zu einem Objekt mit den vorhandenen Feldern in der stabilen Reihenfolge id, event, data. Der `data`-Text wird per JSON.parse geparst, sodass ein Payload wie `data: {"a":1}` zu einem verschachtelten Objekt `"data": {"a":1}` wird statt zu einem escapten String.
Warum ist die id in der Ausgabe eine Zahl?
SSE-ids sind technisch Strings, aber echte Push-Streams verwenden fast immer numerische ids wie `id: 0`. Besteht eine id nur aus Ziffern, gibt der Konverter sie als JSON-Zahl aus; jede andere id bleibt ein String.
Was passiert, wenn sich data über mehrere Zeilen erstreckt?
Gemäß der SSE-Spezifikation werden mehrere `data:`-Zeilen innerhalb eines Ereignisses mit einem Zeilenumbruch verbunden, bevor sie als ein einziger Wert geparst werden. Ist der verbundene Text kein gültiges JSON, behält der Konverter den Rohtext bei und zeigt eine Warnung, damit nichts unbemerkt verloren geht.
Was, wenn ein data-Payload kein gültiges JSON ist?
Statt die gesamte Umwandlung abzubrechen, behält dieses Ereignis die Rohdaten als JSON-String bei, und die Seite zeigt eine Warnung mit Blocknummer und Parser-Fehlermeldung. Gültige Ereignisse drumherum werden trotzdem normal umgewandelt.
Was ist der Unterschied zwischen SSE zu JSON und der JSONL-Formatierung?
JSONL hat in jeder Zeile ein vollständiges JSON-Objekt. SSE hat dagegen beschriftete `id/event/data`-Zeilen, die durch Leerzeilen zu Ereignissen gruppiert werden, und nur der data-Teil ist JSON. SSE zu JSON versteht diese Feldbeschriftungen und die Ereignisgrenzen per Leerzeile, während eine JSONL-Formatierung jede Zeile unabhängig behandeln würde.
Lädt dieser Konverter meine Stream-Daten hoch?
Nein. Parsen und Formatieren laufen vollständig in deinem Browser, sodass Push-Daten, Tokens und Gesprächsinhalte nie deinen Rechner verlassen.
Glossar
- SSE
- Server-Sent Events, ein Standard für einseitiges Push-Streaming vom Server zum Client über HTTP.
- text/event-stream
- Der MIME-Medientyp eines SSE-Antwortkörpers, der durch Leerzeilen getrennte Feldzeilen enthält.
- Ereignisblock
- Eine Gruppe aufeinanderfolgender nicht-leerer Feldzeilen, die zusammen ein Push-Ereignis beschreiben und durch eine Leerzeile beendet werden.
- data-Feld
- Das SSE-Feld, das den Ereignis-Payload trägt; mehrere data-Zeilen in einem Ereignis werden mit einem Zeilenumbruch verbunden und sind typischerweise JSON.
- event-Feld
- Das optionale Feld, das den Ereignistyp benennt; fehlt es, versendet der Browser es als das generische „message“-Ereignis.
- id-Feld
- Der optionale Last-Event-ID-Wert zum Wiederaufnehmen eines Streams; dieser Konverter gibt numerische ids als JSON-Zahlen aus.
- retry-Feld
- Ein optionales Feld, das dem Client die Wartezeit für die Neuverbindung in Millisekunden nennt; es darf nur ASCII-Ziffern enthalten.
- Kommentarzeile
- Eine mit einem Doppelpunkt beginnende Zeile, oft als Heartbeat oder Keep-alive genutzt, die beim Aufbau der Ereignisse ignoriert wird.
Authoritative References
- MDN Web DocsMDN: Server-Sent Events
- HTML Living StandardWHATWG: Server-Sent Events (Event-Stream-Format)
- JSON-Komprimierung
- CSV zu JSON
- JSON zu CSV
- JSON Diff
- JSON Escape / Unescape
- JSON Flatten
- JSON-Formatierung
- JSONL-Formatierung
- SSE zu JSON
- JSON-Generator
- JSONPath Online-Abfrage
- JSON zusammenführen
- JSON reparieren
- JSON Schema Validator
- JSON sortieren
- JSON Stringify
- JSON zu HTML-Tabelle
- JSON zu Java
- JSON zu Markdown
- JSON in SQL umwandeln
- JSON zu TOML
- JSON zu TypeScript
- XML zu JSON
- JSON zu XML
- YAML zu JSON
- JSON zu YAML
- JSON zu Python
- JSON zu Go
- JSON zu Rust
- JSON zu Swift
- JSON zu C#
- JSON zu C++
- JSON zu PHP