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

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

  1. Füge den rohen SSE-Stream in die linke Textarea ein, mit id-/event-/data-Zeilen und je einer Leerzeile zwischen den Ereignissen
  2. Die rechte Seite aktualisiert sich automatisch und zeigt ein JSON-Array mit einem Objekt je Ereignis
  3. Prüfe das Warnfeld, falls ein data-Payload kein gültiges JSON ist oder ein Feld fehlerhaft wirkt
  4. 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.

WerkzeugEingabeformKernfähigkeitEinsatzszenario
SSE zu JSONid-/event-/data-Blöcke, getrennt durch LeerzeilenVersteht SSE-Felder und parst jeden data-PayloadServer-Push-Streams, text/event-stream, KI-Streaming-Chunks
JSONL-FormatierungEin vollständiges JSON-Objekt pro ZeilePrüft und formatiert jede Zeile unabhängigNDJSON-Protokolle, Archivereignisse, zeilengetrennte Exporte
JSON-FormatierungEin vollständiges JSON-Objekt oder -ArrayVerschönert ein einzelnes vollständiges JSON-DokumentAPI-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