SSE 轉 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 轉 JSON?

Server-Sent Events(SSE)是一種單向串流協定:伺服器在內容類型為 text/event-stream 的 HTTP 回應中持續寫入 UTF-8 文字事件。在線格式上,每個事件都是若干欄位列,例如 id: 1、event: MESSAGE、data: {...},並以一個空行表示該事件結束。

原始 SSE 利於傳輸卻不便於閱讀與除錯:每個事件都重複欄位名稱、JSON 資料隱藏在 data: 前綴之後,長串流更是擠成一整片文字。把 SSE 轉成 JSON,就是把每個事件正規化為一個普通物件,再把所有事件收集進一個 JSON 陣列。

本轉換器遵循事件串流解析規則:按換行切分、把空行作為派發邊界、只移除欄位冒號後的一個可選空白、以換行合併重複的 data 列、忽略以冒號開頭的註解,再把每個 data 承載資料解析為 JSON,保留巢狀結構。

最終得到一個標準、帶縮排的 JSON 陣列,便於閱讀、複製到程式、與另一次擷取比對或交給下游工具;任何無法解析的資料都會被明確標註,而不是被丟棄。

適用場景

  • 除錯以 SSE 事件區塊推送的大型模型或 AI Agent 串流回應,例如 STREAM_CHUNK、CHUNK_DELTA
  • 把瀏覽器開發人員工具 Network 面板複製的 text/event-stream 回應轉成可讀 JSON
  • 檢視即時推送或聊天後端的心跳、ack 以及完整訊息事件
  • 把擷取到的 SSE 串流轉成 JSON 陣列後再傳給同事協同排查
  • 不必手動移除 data: 前綴即可展開每個事件裡巢狀的 data 承載資料
  • 離線回放錄製的推送串流,並依 id 比對事件先後順序
  • 把 SSE 事件資料整理成需要 JSON 陣列的分析、日誌或試算表流程
  • 前後端串接時驗證伺服器是否依預期推送事件名稱與資料結構
  • 把多行 data 欄位合併為每個事件物件中的單一解析值
  • 以結構化、易於摺疊的形式檢視來自 Proxy、閘道或 curl 輸出的 SSE 訊息
  • 把沿用 SSE 線格式的 Webhook 或訊息佇列事件串流轉成 JSON
  • 透過觀察 id、event、data 如何對應到 JSON 物件來學習 Server-Sent Events 線格式

使用方法

  1. 把原始 SSE 串流貼到左側文字框,事件之間以空行分隔,每列形如 id/event/data
  2. 右側會自動更新,顯示每個事件對應一個物件的 JSON 陣列
  3. 若某個 data 不是合法 JSON 或欄位異常,請查看警示訊息
  4. 用「複製」拷貝整個 JSON 陣列,也可先按「範例」載入內建範例

功能特點

  • 把原始 SSE 事件串流轉換成標準 JSON 陣列,每則推送事件對應一個物件
  • 依空行對事件分區塊,遵循 Server-Sent Events 的事件派發模型
  • 依「欄位: 值」解析每一列,並自動移除冒號後的一個空白
  • 以 JSON.parse 解析每個 data 承載資料,讓巢狀內容成為真正的物件而非跳脫字串
  • 欄位順序固定為 id、event、data,純數字 id 會轉成 JSON 數字
  • 支援多行 data 欄位、以冒號開頭的註解列,以及結尾沒有空行的事件串流
  • 對無法解析的 data、未知或格式錯誤的欄位提供所在區塊與列號警示
  • 左側 textarea 輸入、右側 JSON 預覽的分欄版面,附範例、清空、複製與事件統計,全程於瀏覽器本機執行

SSE 轉 JSON vs JSONL 格式化 vs JSON 格式化

這幾個工具處理的輸入形態不同,選對工具可省去手動移除前綴、包陣列的麻煩。

工具輸入形態核心能力適用情境
SSE 轉 JSON以空行分隔的 id/event/data 區塊辨識 SSE 欄位並解析每個 data 承載資料伺服器推送串流、text/event-stream、AI 串流分塊
JSONL 格式化每列一個完整 JSON 物件逐列獨立校驗與格式化NDJSON 日誌、事件封存、按列分隔的匯出
JSON 格式化單一完整 JSON 物件或陣列美化一整份完整 JSON 文件API 回應、設定檔、一次性資料

最佳实践

複製事件串流時保留事件之間的空行

空行是區分相鄰 SSE 事件的邊界。若複製時移除空行,不同事件會被合併成同一個區塊,轉換結果也就無法對應原始派發順序。

借助警示中的區塊編號、列號快速定位問題

當某個 data 解析失敗時,警示會指出是第幾個事件區塊、哪一列。把它與附近一個正常事件比對,通常就能發現括號被截斷、少了引號或分塊被合併的問題。

記住只有 data 欄位會被當作 JSON 解析

id、event、retry 都是 SSE 傳輸層後設資料,會保留為標量值。不要期待工具去解析 event 名稱或 id 裡的 JSON,結構化內容應放在 data 中。

拼合完整訊息前先轉換整段串流分塊

許多 AI 串流會用大量細小的 STREAM_CHUNK 事件拼出一則訊息。可先轉換整段擷取,把每個分塊視為陣列中的一項;需要最終訊息時,再於應用程式碼中合併這些分塊的承載資料。

對外分享轉換後的 JSON 前先去識別化

轉換雖然在本機完成,但一旦把 JSON 陣列複製到工單或聊天中就離開了你的機器。分享前請移除權杖、使用者 ID 與私人對話內容。

常見問題

什麼是 SSE(Server-Sent Events)?

SSE 是伺服器透過 HTTP、以 text/event-stream 內容類型向瀏覽器單向推送文字事件的標準方式。每個事件由 id、event、data 等文字列組成,事件與事件之間以一個空行分隔。

這個工具如何把串流切分成一個個事件?

它遵循 SSE 的派發模型:先按列切分,連續的非空列組成一個事件區塊,遇到空行就把該區塊派發為新事件;即使最後一個事件區塊後面沒有空行也會輸出,以冒號開頭的註解列會被忽略。

輸出的 JSON 長什麼樣子?

輸出是一個 JSON 陣列,每個輸入事件對應一個物件,只包含實際出現的欄位,且欄位順序固定為 id、event、data。其中 data 文字會以 JSON.parse 解析,因此 data: {"a":1} 會變成巢狀物件 "data": {"a":1},而不是被跳脫的字串。

為什麼輸出裡的 id 是數字?

SSE 的 id 在協定層面是字串,但真實推送串流幾乎都使用 id: 0 這類數字編號。當 id 只由數字組成時,本工具會輸出為 JSON 數字,其他狀況則保留為字串。

data 跨越多列時如何處理?

依據 SSE 規範,同一事件裡的多行 data: 會先以換行字元合併成一個值再解析。若合併後的文字不是合法 JSON,工具會保留原始文字並提供警示,不會悄悄遺失資料。

如果某個 data 不是合法 JSON 會怎樣?

不會讓整次轉換失敗:該事件會把原始 data 保留為 JSON 字串,頁面同時顯示帶區塊編號與解析錯誤訊息的警示,前後的合法事件仍會正常轉換。

SSE 轉 JSON 和 JSONL 格式化有什麼不同?

JSONL 是每一列就是一個完整 JSON 物件;SSE 則是帶 id/event/data 標籤的多列、並以空行為事件分組,而且只有 data 部分是 JSON。SSE 轉 JSON 能辨識這些欄位標籤與空行事件邊界,JSONL 格式化則會把每一列都獨立處理。

轉換時會上傳我的串流資料嗎?

不會。解析與格式化全程在瀏覽器本機完成,推送資料、權杖、對話內容都不會傳送到伺服器。

術語表

SSE
Server-Sent Events,伺服器透過 HTTP 向用戶端單向推送事件串流的標準協定。
text/event-stream
SSE 回應主體的 MIME 媒體類型,內容由欄位列組成,事件之間以空行分隔。
事件區塊
一組連續的非空欄位列,共同描述一則推送事件,以空行結束。
data 欄位
承載事件資料的 SSE 欄位;同一事件內的多行 data 會以換行合併,通常是 JSON。
event 欄位
可選欄位,用於指定事件類型;缺少時瀏覽器會以通用的 message 事件派發。
id 欄位
可選的「最後事件 ID」,用於斷線續傳;本工具會把純數字 id 輸出為 JSON 數字。
retry 欄位
可選欄位,告訴用戶端斷線重連的等待毫秒數,值只能包含 ASCII 數字。
註解列
以冒號開頭的列,常用作心跳或連線保活,在建立事件時會被忽略。

Authoritative References