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

Công cụ chuyển đổi chuyên biệt cho dữ liệu đẩy Server-Sent Events (SSE). Dán các khối id/event/data thô ở bên trái, bên phải sẽ ngay lập tức dựng thành một mảng JSON chuẩn, trong đó mỗi sự kiện được đẩy đi thành một đối tượng duy nhất cùng id, tên sự kiện và phần dữ liệu đã được phân tích.

Đề xuất Liên quan

Chuyển đổi SSE sang JSON là gì?

Server-Sent Events (SSE) là một giao thức streaming một chiều, trong đó máy chủ ghi các sự kiện văn bản UTF-8 trên một phản hồi HTTP kiểu `text/event-stream`. Trên đường truyền, mỗi sự kiện là một chuỗi các dòng trường như `id: 1`, `event: MESSAGE` và `data: {...}`, còn một dòng trống đánh dấu kết thúc sự kiện đó.

SSE thô tiện cho việc truyền tải nhưng khó đọc và khó gỡ lỗi. Tên trường lặp lại ở mọi sự kiện, payload JSON nằm sau tiền tố `data:`, và các luồng dài gộp thành một bức tường chữ. Chuyển SSE sang JSON nghĩa là chuẩn hóa mỗi sự kiện thành một đối tượng thuần và gom tất cả sự kiện vào một mảng JSON.

Công cụ chuyển đổi này tuân theo các quy tắc diễn giải event-stream: nó tách theo ngắt dòng, coi dòng trống là biên dispatch, loại bỏ đúng một dấu cách tùy chọn sau dấu hai chấm của trường, nối các dòng data lặp lại bằng dấu xuống dòng, và bỏ qua các chú thích bắt đầu bằng dấu hai chấm. Sau đó nó phân tích mỗi payload data thành JSON để giữ nguyên các cấu trúc lồng nhau.

Kết quả là một mảng JSON chuẩn, có thụt lề, dễ đọc, dễ copy vào code, dễ so sánh với một bản bắt khác hoặc đưa vào các công cụ phía sau, đồng thời mọi payload không phân tích được sẽ được gắn cờ thay vì bị bỏ đi.

Trường hợp sử dụng

  • Gỡ lỗi phản hồi streaming của LLM hoặc tác tử AI đến dưới dạng các mảnh sự kiện SSE như STREAM_CHUNK hay CHUNK_DELTA
  • Biến phản hồi text/event-stream sao chép từ tab Network của DevTools trình duyệt thành JSON dễ đọc
  • Kiểm tra các sự kiện heartbeat, ack và sự kiện toàn bộ tin nhắn từ backend đẩy thời gian thực hoặc chat
  • Chuyển dữ liệu đẩy SSE đã bắt được thành mảng JSON trước khi chia sẻ với đồng nghiệp để gỡ lỗi
  • Trích xuất và mở rộng phần dữ liệu lồng nhau của mọi sự kiện mà không cần xóa thủ công tiền tố data:
  • Phát lại một luồng đẩy đã ghi ở chế độ ngoại tuyến và so sánh thứ tự sự kiện theo id
  • Chuẩn bị dữ liệu sự kiện SSE cho phân tích, log hoặc bảng tính vốn mong đợi một mảng JSON
  • Xác minh trong quá trình tích hợp frontend-backend rằng máy chủ phát ra đúng tên sự kiện và hình dạng payload kỳ vọng
  • Làm phẳng các trường data nhiều dòng thành một giá trị đã phân tích cho mỗi đối tượng sự kiện
  • Kiểm tra các dấu vết SSE từ proxy, gateway hay output curl dưới dạng có cấu trúc, dễ thu gọn
  • Chuyển các luồng sự kiện kiểu Webhook hay hàng đợi tin nhắn vốn tái dùng định dạng truyền SSE thành JSON
  • Học định dạng truyền Server-Sent Events bằng cách nhìn cách id, event, data ánh xạ thành đối tượng JSON

Cách Sử dụng

  1. Dán luồng SSE thô vào ô textarea bên trái, gồm các dòng id/event/data và một dòng trống giữa các sự kiện
  2. Bên phải tự cập nhật và hiển thị một mảng JSON với mỗi sự kiện một đối tượng
  3. Kiểm tra bảng cảnh báo nếu một phần dữ liệu không phải JSON hợp lệ hoặc một trường có vẻ sai cấu trúc
  4. Dùng Sao chép để copy toàn bộ mảng JSON, hoặc Mẫu để nạp trước ví dụ dựng sẵn

Tính năng

  • Chuyển một luồng sự kiện SSE thô thành mảng JSON chuẩn, mỗi sự kiện được đẩy đi thành một đối tượng
  • Nhóm các dòng thành sự kiện theo dòng trống, đúng theo mô hình dispatch của Server-Sent Events
  • Phân tích mỗi dòng dưới dạng field: value và tự loại bỏ dấu cách đơn sau dấu hai chấm
  • Phân tích mọi phần dữ liệu bằng JSON.parse để payload lồng nhau thành đối tượng thật thay vì chuỗi đã escape
  • Giữ thứ tự khóa ổn định id, event, data và biến id dạng số thành số JSON
  • Hỗ trợ trường data nhiều dòng, dòng chú thích bắt đầu bằng dấu hai chấm và luồng không có dòng trống cuối
  • Báo cáo phần dữ liệu không hợp lệ và các trường lạ hoặc sai cấu trúc kèm số khối và số dòng
  • Bố cục chia đôi ô nhập textarea và vùng xem trước JSON, có mẫu, xóa, sao chép và thống kê sự kiện; mọi xử lý chạy hoàn toàn trong trình duyệt

SSE to JSON vs trình định dạng JSONL vs trình định dạng JSON

Các công cụ này xử lý những hình dạng đầu vào khác nhau. Chọn đúng công cụ sẽ tránh việc tự tay bóc tiền tố và bọc mảng.

Công cụHình dạng đầu vàoĐiểm mạnh chínhKhi nào nên dùng
SSE to JSONCác khối id/event/data phân tách bằng dòng trốngHiểu các trường SSE và phân tích từng payload dataLuồng đẩy máy chủ, text/event-stream, các mảnh streaming của AI
Trình định dạng JSONLMỗi dòng một đối tượng JSON hoàn chỉnhKiểm tra và định dạng từng dòng một cách độc lậpLog NDJSON, sự kiện đã lưu trữ, bản xuất phân tách theo dòng
Trình định dạng JSONMột đối tượng hoặc mảng JSON hoàn chỉnhLàm đẹp một tài liệu JSON đơn lẻPhản hồi API, tệp cấu hình, payload dùng một lần

Best Practices

Giữ nguyên dòng trống giữa các sự kiện khi sao chép một luồng

Chính dòng trống mới tách một sự kiện SSE này với sự kiện kế tiếp. Nếu bạn xóa dòng trống khi sao chép, các sự kiện riêng biệt có thể gộp thành một khối và kết quả chuyển đổi sẽ không còn khớp với thứ tự dispatch ban đầu.

Dùng số khối và số dòng trong cảnh báo để nhảy thẳng tới vấn đề

Khi một payload data phân tích thất bại, cảnh báo sẽ nêu tên khối sự kiện và dòng gây lỗi. So sánh khối đó với một sự kiện hợp lệ gần kề để phát hiện ngoặc đóng bị cắt, thiếu dấu nháy hoặc các mảnh đã bị nối.

Nhớ rằng chỉ trường data mới được phân tích thành JSON

Các trường id, event, retry là siêu dữ liệu truyền tải của SSE và giữ nguyên dưới dạng giá trị vô hướng. Đừng kỳ vọng công cụ phân tích JSON xuất hiện trong tên sự kiện hay id; nội dung có cấu trúc thuộc về data.

Ghép các mảnh streaming rời rạc trước khi chuyển đổi một tin nhắn hoàn chỉnh

Nhiều luồng AI gửi đi rất nhiều sự kiện STREAM_CHUNK nhỏ tạo nên một tin nhắn. Hãy chuyển đổi toàn bộ bản bắt trước để thấy mọi mảnh như một phần tử mảng, rồi mới gộp các payload mảnh trong mã ứng dụng nếu cần tin nhắn cuối cùng.

Vệ sinh các payload nhạy cảm trước khi chia sẻ JSON đã chuyển đổi

Việc chuyển đổi là cục bộ, nhưng một khi bạn copy mảng JSON vào một ticket hay đoạn chat thì nó đã rời khỏi máy bạn. Hãy gỡ bỏ token, id người dùng và nội dung hội thoại riêng tư khỏi đầu ra trước khi chia sẻ.

Câu hỏi Thường gặp

SSE (Server-Sent Events) là gì?

SSE là cách chuẩn để máy chủ đẩy các sự kiện dạng văn bản tới trình duyệt qua HTTP bằng kiểu nội dung `text/event-stream`. Mỗi sự kiện được tạo từ các dòng văn bản như `id`, `event`, `data`, và các sự kiện cách nhau bởi một dòng trống.

Công cụ này tách luồng thành các sự kiện bằng cách nào?

Nó tuân theo mô hình dispatch của SSE: đầu vào được tách thành các dòng, các dòng không trống liền kề tạo thành một khối sự kiện, và một dòng trống sẽ dispatch khối đó thành một sự kiện mới. Khối cuối cùng không có dòng trống cuối vẫn được phát ra, còn các dòng chú thích bắt đầu bằng dấu hai chấm sẽ bị bỏ qua.

JSON đầu ra trông như thế nào?

Kết quả là một mảng JSON. Mỗi sự kiện đầu vào thành một đối tượng với các trường đã có, theo thứ tự ổn định id, event, data. Phần văn bản `data` được phân tích bằng JSON.parse, nên một payload kiểu `data: {"a":1}` sẽ thành đối tượng lồng nhau `"data": {"a":1}` thay vì một chuỗi đã escape.

Vì sao id trong đầu ra là một số?

Về kỹ thuật id của SSE là chuỗi, nhưng các luồng đẩy thực tế gần như luôn dùng id dạng số như `id: 0`. Khi một id chỉ gồm các chữ số, công cụ chuyển đổi phát ra nó dưới dạng số JSON; id nào khác được giữ nguyên dưới dạng chuỗi.

Khi data trải dài trên nhiều dòng thì sao?

Theo đặc tả SSE, nhiều dòng `data:` trong cùng một sự kiện được nối với nhau bằng ký tự xuống dòng trước khi được phân tích thành một giá trị. Nếu văn bản sau khi nối không phải JSON hợp lệ, công cụ giữ lại văn bản gốc và thêm cảnh báo để không có gì bị mất thầm lặng.

Nếu một payload data không phải JSON hợp lệ thì sao?

Thay vì làm hỏng toàn bộ quá trình chuyển đổi, sự kiện đó giữ lại dữ liệu thô dưới dạng chuỗi JSON và trang hiển thị cảnh báo kèm số khối và thông báo lỗi của trình phân tích. Các sự kiện hợp lệ xung quanh vẫn được chuyển đổi bình thường.

SSE to JSON khác gì với trình định dạng JSONL?

JSONL có một đối tượng JSON hoàn chỉnh trên mỗi dòng. Còn SSE lại có các dòng nhãn `id/event/data` được nhóm thành sự kiện theo dòng trống, và chỉ phần data mới là JSON. SSE to JSON hiểu các nhãn trường đó và ranh giới sự kiện theo dòng trống, trong khi trình định dạng JSONL sẽ coi mỗi dòng là độc lập.

Công cụ chuyển đổi này có tải lên dữ liệu luồng của tôi không?

Không. Việc phân tích và định dạng chạy hoàn toàn trong trình duyệt của bạn, nên dữ liệu đẩy, token và nội dung hội thoại không bao giờ rời khỏi máy của bạn.

Thuật ngữ

SSE
Viết tắt của Server-Sent Events, một chuẩn cho streaming đẩy một chiều từ máy chủ tới client qua HTTP.
text/event-stream
Kiểu phương tiện MIME của phần thân phản hồi SSE, chứa các dòng trường phân tách bằng dòng trống.
Khối sự kiện
Một nhóm các dòng trường không trống liền kề cùng mô tả một sự kiện được đẩy đi, kết thúc bằng một dòng trống.
trường data
Trường SSE mang payload của sự kiện; nhiều dòng data trong cùng một sự kiện được nối bằng dấu xuống dòng và thường là JSON.
trường event
Trường tùy chọn đặt tên cho loại sự kiện; khi vắng mặt, trình duyệt sẽ dispatch nó dưới dạng sự kiện 'message' chung.
trường id
Giá trị last-event-id tùy chọn dùng để tiếp tục một luồng; công cụ này phát ra id dạng số dưới dạng số JSON.
trường retry
Trường tùy chọn cho client biết thời gian chờ kết nối lại tính bằng mili giây; nó chỉ được chứa các chữ số ASCII.
Dòng chú thích
Một dòng bắt đầu bằng dấu hai chấm, thường dùng làm heartbeat hoặc keep-alive, và bị bỏ qua khi dựng các sự kiện.

Authoritative References