SSE 轉 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.
專為 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 線格式
使用方法
- 把原始 SSE 串流貼到左側文字框,事件之間以空行分隔,每列形如 id/event/data
- 右側會自動更新,顯示每個事件對應一個物件的 JSON 陣列
- 若某個 data 不是合法 JSON 或欄位異常,請查看警示訊息
- 用「複製」拷貝整個 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
- MDN Web DocsMDN:Server-sent events(伺服器發送事件)
- HTML Living StandardWHATWG:Server-sent events 事件串流格式規範
- JSON 壓縮
- CSV 轉 JSON
- JSON 轉 CSV
- JSON Diff
- JSON Escape / Unescape
- JSON 扁平化
- JSON 格式化
- JSONL 格式化
- SSE 轉 JSON
- JSON 產生器
- JSONPath 查詢
- JSON 合併
- JSON 修復
- JSON Schema 驗證器
- JSON 排序
- JSON Stringify
- JSON 轉 HTML 表格
- JSON 轉 Java
- JSON 轉 Markdown
- JSON 轉 SQL
- JSON 轉 TOML
- JSON 轉 TypeScript
- XML 轉 JSON
- JSON 轉 XML
- YAML 轉 JSON
- JSON 轉 YAML
- JSON 轉 Go
- JSON 轉 Rust
- JSON 轉 Swift
- JSON轉C#
- JSON 轉 C++
- JSON 轉 PHP
- JSON 轉 Python