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

Server-Sent Events(SSE)のプッシュデータに特化した変換ツールです。左側に生の id/event/data ブロックを貼り付けると、右側に標準的な JSON 配列が即時表示され、プッシュされた各イベントが id・イベント名・解析済み data ペイロードを持つ単一オブジェクトになります。

関連おすすめ

SSE to JSON 変換とは何ですか?

Server-Sent Events(SSE)は単方向のストリーミングプロトコルで、サーバーが `text/event-stream` 型の HTTP 応答上に UTF-8 テキストイベントを書き出します。ワイヤー上では各イベントは `id: 1`、`event: MESSAGE`、`data: {...}` のようなフィールド行の並びで、空行がそのイベントの終端を示します。

生の SSE は転送には便利ですが、読んだりデバッグしたりするのは厄介です。フィールド名はすべてのイベントで繰り返され、JSON ペイロードは `data:` プレフィックスの背後にあり、長いストリームは一面のテキストに潰れてしまいます。SSE を JSON へ変換するとは、各イベントを素のオブジェクトへ正規化し、すべてのイベントを1つの JSON 配列へ集めることです。

この変換ツールはイベントストリームの解釈ルールに従います。改行で分割し、空行をディスパッチ境界とし、フィールドコロン直後の任意のスペース1つだけを除去し、繰り返される data 行を改行で結合し、コロン始まりのコメントを無視します。そのうえで各 data ペイロードを JSON として解析し、ネスト構造を保ちます。

結果は標準的でインデントされた JSON 配列になり、読む・コードへ貼り付ける・別のキャプチャと diff する・下流ツールへ流すことが容易です。解析できないペイロードは捨てられずフラグが立てられます。

ユースケース

  • STREAM_CHUNK や CHUNK_DELTA のような SSE イベントチャンクで届く LLM / AI エージェントのストリーミング応答をデバッグ
  • ブラウザの開発者ツール Network タブからコピーした text/event-stream 応答を読みやすい JSON へ変換
  • リアルタイムプッシュやチャットのバックエンドから届くハートビート・ack・完全メッセージの各イベントを点検
  • キャプチャした SSE プッシュデータを JSON 配列へ変換してから、デバッグ用にチームメンバーと共有
  • すべてのイベントからネストした data ペイロードを取り出して展開。手作業で data: プレフィックスを除去する必要なし
  • 録画したプッシュストリームをオフラインで再生し、id によるイベント順序を比較
  • JSON 配列を期待する分析・ログ・スプレッドシート向けに SSE イベントデータを準備
  • フロントエンドとバックエンドの連携時、サーバーが期待どおりのイベント名とペイロード形状で送出しているか検証
  • 複数行の data フィールドを、イベントオブジェクト1つにつき1つの解析済み値へ平坦化
  • プロキシ・ゲートウェイ・curl 出力からの SSE トレースを、構造化され折りたたみやすい形で点検
  • SSE のワイヤーフォーマットを再利用する Webhook 風やメッセージキューのイベントストリームを JSON へ変換
  • id・event・data が JSON オブジェクトへどう対応するかを見て、Server-Sent Events のワイヤーフォーマットを学習

使い方

  1. 生の SSE ストリームを左側の textarea に貼り付けます。id/event/data の各行とイベント間の空行を含めてください
  2. 右側が自動更新され、イベント1つにつきオブジェクト1つの JSON 配列が表示されます
  3. data ペイロードが有効な JSON でない場合や、フィールドの不正が疑われる場合は警告パネルを確認
  4. コピーで JSON 配列全体を送り、まずサンプルで内蔵例を読み込むこともできます

特徴

  • 生の SSE イベントストリームを標準的な JSON 配列へ変換。プッシュされたイベント1つにつきオブジェクト1つを生成
  • Server-Sent Events のディスパッチモデルに従い、空行で行をイベントへグルーピング
  • 各行を field: value として解析し、コロン直後の半角スペース1つを取り除く
  • すべての data ペイロードを JSON.parse で解析し、ネストしたペイロードをエスケープ文字列ではなく実際のオブジェクトにする
  • id・event・data のキー順を安定させ、数字の id は JSON の数値へ変換
  • 複数行にまたがる data フィールド、コロンで始まるコメント行、末尾の空行がないストリームにも対応
  • 無効な data ペイロードや未知・不正なフィールドをブロック番号・行番号付きで通知
  • 分割された textarea 入力と JSON プレビューの2ペイン構成。サンプル・クリア・コピー・イベント統計付き。処理はすべてブラウザ内で完結

SSE to JSON vs JSONLフォーマッター vs JSONフォーマッター

これらのツールは異なる入力形状を扱います。正しいツールを選べば、手作業でプレフィックスを除去したり配列で包んだりする必要がなくなります。

ツール入力の形状主な強み使いどころ
SSE to JSON空行で分割された id/event/data ブロックSSE フィールドを理解し、各 data ペイロードを解析サーバープッシュストリーム、text/event-stream、AI ストリーミングチャンク
JSONLフォーマッター1行に1つの完全な JSON オブジェクト各行を独立して検証・整形NDJSON ログ、アーカイブイベント、行区切りエクスポート
JSONフォーマッター完全な1つの JSON オブジェクトまたは配列JSON ドキュメント全体を整形API レスポンス、設定ファイル、単発のペイロード

Best Practices

ストリームをコピーするときはイベント間の空行を保つ

空行こそが SSE イベント同士を分ける境界です。コピー時に空行を取り除くと、別々のイベントが1つのブロックに結合してしまい、変換結果が元のディスパッチ順と一致しなくなります。

警告のブロック番号・行番号を使って問題箇所へ飛ぶ

data ペイロードの解析に失敗した場合、警告はイベントブロック番号と問題の行を示します。そのブロックを近くの有効なイベントと見比べると、閉じ括弧の欠け、引用符の不足、チャンクの結合を見つけやすくなります。

JSON として解析されるのは data フィールドだけと覚えておく

id・event・retry フィールドは SSE トランスポートのメタデータで、スカラー値のまま保持されます。イベント名や id の中に現れる JSON を変換ツールが解析すると期待しないでください。構造化された内容は data に置きます。

完全なメッセージを変換する前に部分的なストリーミングチャンクを組み立てる

多くの AI ストリームは、1つのメッセージを構成する小さな STREAM_CHUNK イベントを多数送ります。まずキャプチャ全体を変換して各チャンクを配列要素として確認し、必要ならアプリケーションコード側でチャンクのペイロードを結合して最終メッセージを得ます。

変換後の JSON を共有する前に機密ペイロードを除去する

変換はローカルで行われますが、JSON 配列をチケットやチャットにコピーした時点で端末の外に出ます。共有前に出力からトークン、ユーザー id、プライベートな会話文を除去してください。

よくある質問

SSE(Server-Sent Events)とは何ですか?

SSE は、サーバーが `text/event-stream` コンテンツタイプを使って HTTP 経由でブラウザにテキストイベントをプッシュする標準的な方式です。各イベントは `id`、`event`、`data` といったテキスト行で構成され、イベント同士は空行で区切られます。

このツールはストリームをどうイベントに分割しますか?

SSE のディスパッチモデルに従います。入力を行に分割し、連続する空でない行が1つのイベントブロックを成し、空行がそのブロックを新しいイベントとしてディスパッチします。末尾に空行のない最後のブロックもそのまま送出され、コロンで始まるコメント行は無視されます。

出力の JSON はどのような形になりますか?

結果は1つの JSON 配列です。入力イベント1つが1つのオブジェクトになり、存在したフィールドが id・event・data の安定順で並びます。`data` のテキストは JSON.parse で解析されるため、`data: {"a":1}` のようなペイロードは、エスケープ文字列ではなくネストしたオブジェクト `"data": {"a":1}` になります。

出力で id が数値になるのはなぜですか?

技術的には SSE の id は文字列ですが、実際のプッシュストリームでは `id: 0` のような数値 id がほぼ常に使われます。id が数字だけで構成される場合、変換ツールはそれを JSON の数値として出力し、それ以外の id は文字列のまま保持します。

data が複数行にまたがる場合はどうなりますか?

SSE 仕様に従い、1つのイベント内の複数の `data:` 行は改行文字で結合されてから1つの値として解析されます。結合後のテキストが有効な JSON でない場合、変換ツールは生のテキストを保持し、警告を追加して何も黙って失われないようにします。

data ペイロードが有効な JSON でない場合は?

変換全体が失敗するのではなく、そのイベントは生の data を JSON 文字列として保持し、ページがブロック番号とパーサーのエラーメッセージ付きの警告を表示します。周囲の有効なイベントは通常どおり変換されます。

SSE to JSON と JSONLフォーマッターの違いは何ですか?

JSONL は各行に完全な JSON オブジェクトが1つ並びます。一方 SSE は、空行でイベントにグルーピングされた `id/event/data` のラベル付き行を持ち、JSON なのは data 部分だけです。SSE to JSON はそれらのフィールドラベルと空行によるイベント境界を理解しますが、JSONLフォーマッターは各行を独立して扱います。

この変換ツールはストリームデータをアップロードしますか?

いいえ。解析と整形はすべてブラウザ内で実行されるため、プッシュデータ、トークン、会話内容がお使いの端末から出ることはありません。

用語集

SSE
Server-Sent Events の略で、HTTP 経由のサーバーからクライアントへの片方向プッシュストリーミングの標準規格。
text/event-stream
SSE 応答ボディの MIME メディアタイプ。空行で区切られたフィールド行を含む。
イベントブロック
連続する空でないフィールド行のまとまりで、空行で終端され、1つのプッシュイベントを記述する。
data フィールド
イベントのペイロードを担う SSE フィールド。1つのイベント内の複数の data 行は改行で結合され、通常は JSON。
event フィールド
イベントの種類に名前を付ける任意フィールド。省略された場合、ブラウザは汎用の 'message' イベントとしてディスパッチする。
id フィールド
ストリームの再開に使われる任意の last-event-id 値。この変換ツールは数値 id を JSON の数値として出力する。
retry フィールド
再接続待ち時間をミリ秒でクライアントに伝える任意フィールド。ASCII 数字のみを含む必要がある。
コメント行
コロンで始まる行。ハートビートやキープアライブに使われることが多く、イベント構築時には無視される。

Authoritative References