SSE na 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.
Skondensowany konwerter danych push z Server-Sent Events (SSE). Wklej po lewej surowe bloki id/event/data, a po prawej natychmiast pojawi się standardowa tablica JSON, w której każde wypchnięte zdarzenie staje się pojedynczym obiektem z jego id, nazwą zdarzenia i sparsowanym ładunkiem danych.
Powiązane Rekomendacje
Na czym polega konwersja SSE na JSON?
Server-Sent Events (SSE) to jednokierunkowy protokół strumieniowy, w którym serwer zapisuje zdarzenia tekstowe UTF-8 w odpowiedzi HTTP typu `text/event-stream`. Na przewodzie każde zdarzenie to sekwencja wierszy pól, takich jak `id: 1`, `event: MESSAGE` i `data: {...}`, a pusty wiersz oznacza koniec tego zdarzenia.
Surowe SSE jest wygodne do transportu, ale kłopotliwe do czytania i debugowania. Nazwy pól powtarzają się w każdym zdarzeniu, ładunek JSON znajduje się za prefiksem `data:`, a długie strumienie zamieniają się w ścianę tekstu. Konwersja SSE na JSON oznacza normalizację każdego zdarzenia do zwykłego obiektu i zebranie wszystkich zdarzeń w jedną tablicę JSON.
Ten konwerter podąża za regułami interpretacji strumienia zdarzeń: dzieli po zakończeniach wierszy, traktuje pusty wiersz jako granicę dyspozycji, usuwa dokładnie jedną opcjonalną spację po dwukropku pola, łączy powtórzone wiersze danych znakami nowej linii i ignoruje komentarze poprzedzone dwukropkiem. Następnie parsuje każdy ładunek danych jako JSON, dzięki czemu zagnieżdżone struktury zostają zachowane.
Wynikiem jest standardowa, wcięta tablica JSON, którą łatwo czytać, kopiować do kodu, porównywać z innym przechwyceniem lub zasilać nią dalsze narzędzia, podczas gdy każdy nieparsowalny ładunek jest oznaczany zamiast usuwany.
Przypadki użycia
- Debugować strumieniowe odpowiedzi LLM-a lub agentów AI, które przychodzą jako fragmenty zdarzeń SSE, takie jak STREAM_CHUNK czy CHUNK_DELTA
- Zamienić skopiowaną z zakładki Sieć w narzędziach deweloperskich przeglądarki odpowiedź text/event-stream w czytelny JSON
- Zbadać zdarzenia heartbeat, ack i pełnej wiadomości z backendu czasu rzeczywistego lub czatu
- Przekształcić przechwycone dane push SSE w tablicę JSON przed udostępnieniem ich koledze do debugowania
- Wyodrębnić i rozwinąć zagnieżdżony ładunek danych każdego zdarzenia bez ręcznego usuwania prefiksów data:
- Odtworzyć nagrany strumień push offline i porównać kolejność zdarzeń po id
- Przygotować dane zdarzeń SSE do analiz, logów lub arkuszy, które oczekują tablicy JSON
- Zweryfikować podczas integracji frontendu z backendiem, czy serwer emituje oczekiwane nazwy zdarzeń i kształt ładunku
- Spłaszczyć wielowierszowe pola danych do jednej sparsowanej wartości na obiekt zdarzenia
- Zbadać ślady SSE z proxy, bram lub wyjścia curl w ustrukturyzowanej, zwijanej formie
- Konwertować strumienie zdarzeń w stylu webhooków lub kolejek komunikatów, które ponownie używają formatu drutowego SSE, na JSON
- Poznać format drutowy Server-Sent Events, widząc, jak id, event i data odwzorowują się na obiekty JSON
Jak Używać
- Wklej surowy strumień SSE do lewego pola textarea, z wierszami id/event/data i pustym wierszem między zdarzeniami
- Prawa strona aktualizuje się automatycznie i pokazuje tablicę JSON z jednym obiektem na zdarzenie
- Sprawdź panel ostrzeżeń, jeśli ładunek danych nie jest poprawnym JSON-em albo pole wygląda na błędne
- Użyj Kopiuj, aby skopiować całą tablicę JSON, albo Przykład, aby najpierw wczytać wbudowany przykład
Funkcje
- Zamienia surowy strumień zdarzeń SSE w standardową tablicę JSON – po jednym obiekcie na każde wypchnięte zdarzenie
- Grupuje wiersze w zdarzenia według pustego wiersza, zgodnie z modelem dyspozycji Server-Sent Events
- Parsuje każde pole jako pole: wartość i usuwa pojedynczą spację po dwukropku
- Parsuje każdy ładunek danych przez JSON.parse, więc zagnieżdżone ładunki stają się prawdziwymi obiektami, a nie escapowanymi ciągami
- Utrzymuje stabilną kolejność kluczy id, event i data oraz zamienia numeryczne id na liczby JSON
- Obsługuje wielowierszowe pola data, wiersze komentarza zaczynające się od dwukropka oraz strumienie bez końcowego pustego wiersza
- Zgłasza niepoprawne ładunki danych oraz nieznane lub błędnie zbudowane pola z numerem bloku i wiersza
- Podzielony układ: pole wprowadzania textarea i podgląd JSON, z przykładem, czyszczeniem, kopiowaniem i statystyką zdarzeń; działa w całości w przeglądarce
SSE na JSON a formatowanie JSONL a formatowanie JSON
Te narzędzia obsługują różne kształty danych wejściowych. Wybranie właściwego pozwala uniknąć ręcznego zdejmowania prefiksów i owijania tablic.
| Narzędzie | Kształt danych wejściowych | Główna mocna strona | Kiedy go użyć |
|---|---|---|---|
| SSE na JSON | Bloki id/event/data rozdzielone pustymi wierszami | Rozumie pola SSE i parsuje każdy ładunek danych | Serwerowe strumienie push, text/event-stream, fragmenty strumieniowe AI |
| Formatowanie JSONL | Jeden kompletny obiekt JSON w wierszu | Waliduje i formatuje każdy wiersz niezależnie | Logi NDJSON, zdarzenia archiwalne, eksporty rozdzielane wierszami |
| Formatowanie JSON | Jeden kompletny obiekt lub tablica JSON | Upiększa jeden cały dokument JSON | Odpowiedzi API, pliki konfiguracyjne, jednorazowe payloady |
Best Practices
Zachowuj pusty wiersz między zdarzeniami podczas kopiowania strumienia
Pusty wiersz oddziela jedno zdarzenie SSE od następnego. Jeśli podczas kopiowania usuniesz puste wiersze, odrębne zdarzenia mogą scalić się w jeden blok i konwersja przestanie odpowiadać pierwotnej kolejności dyspozycji.
Używaj numerów bloku i wiersza w ostrzeżeniach, aby przeskoczyć do problemu
Gdy ładunek danych nie uda się sparsować, ostrzeżenie podaje blok zdarzenia i wadliwy wiersz. Porównaj ten blok z pobliskim poprawnym zdarzeniem, by dostrzec ucięty nawias, brakujący cudzysłów albo sklejone fragmenty.
Pamiętaj, że tylko pole data jest parsowane jako JSON
Pola id, event i retry to metadane transportu SSE i pozostają wartościami skalarnymi. Nie oczekuj, że konwerter sparsuje JSON pojawiający się w nazwie zdarzenia lub id; treść strukturalna należy do data.
Zbieraj częściowe fragmenty strumieniowe przed konwersją pełnej wiadomości
Wiele strumieni AI wysyła wiele małych zdarzeń STREAM_CHUNK, które budują jedną wiadomość. Najpierw przekonwertuj całe przechwycenie, aby zobaczyć każdy fragment jako element tablicy, a potem złącz ładunki fragmentów w kodzie aplikacji, jeśli potrzebujesz końcowej wiadomości.
Oczyszczaj wrażliwe ładunki przed udostępnieniem przekonwertowanego JSON
Konwersja jest lokalna, ale gdy skopiujesz tablicę JSON do zgłoszenia lub czatu, opuszcza ona Twój komputer. Usuń tokeny, identyfikatory użytkowników i treści prywatnych rozmów z wyniku przed udostępnieniem.
Często Zadawane Pytania
Co to jest SSE (Server-Sent Events)?
SSE to standardowy sposób, w jaki serwer wypycha zdarzenia tekstowe do przeglądarki przez HTTP z typem treści `text/event-stream`. Każde zdarzenie składa się z wierszy tekstu, takich jak `id`, `event` i `data`, a zdarzenia są oddzielone od siebie pustym wierszem.
Jak to narzędzie dzieli strumień na zdarzenia?
Podąża za modelem dyspozycji SSE: dane wejściowe są dzielone na wiersze, kolejne niepuste wiersze tworzą jeden blok zdarzenia, a pusty wiersz dysponuje ten blok jako nowe zdarzenie. Końcowy blok bez końcowego pustego wiersza też zostaje wyemitowany, a wiersze komentarza zaczynające się od dwukropka są ignorowane.
Jak wygląda wynikowy JSON?
Wynikiem jest jedna tablica JSON. Każde zdarzenie wejściowe staje się jednym obiektem z obecnymi polami, w stabilnej kolejności id, event, data. Tekst `data` jest parsowany przez JSON.parse, więc ładunek taki jak `data: {"a":1}` staje się zagnieżdżonym obiektem `"data": {"a":1}` zamiast escapowanym ciągiem.
Dlaczego id w wyniku jest liczbą?
Id SSE technicznie są ciągami, ale rzeczywiste strumienie push niemal zawsze używają numerycznych id, takich jak `id: 0`. Jeśli id składa się wyłącznie z cyfr, konwerter emituje je jako liczbę JSON; każde inne id pozostaje ciągiem.
Co się dzieje, gdy data obejmuje wiele wierszy?
Zgodnie ze specyfikacją SSE wiele wierszy `data:` wewnątrz jednego zdarzenia jest łączonych znakiem nowej linii, zanim zostaną sparsowane jako jedna wartość. Jeśli połączony tekst nie jest poprawnym JSON-em, konwerter zachowuje surowy tekst i dodaje ostrzeżenie, aby nic nie zginęło po cichu.
Co, jeśli ładunek danych nie jest poprawnym JSON-em?
Zamiast zawodzić całą konwersję, to zdarzenie zachowuje surowe dane jako ciąg JSON, a strona pokazuje ostrzeżenie z numerem bloku i komunikatem błędu parsera. Poprawne zdarzenia w jego okolicy są nadal konwertowane normalnie.
Jaka jest różnica między SSE na JSON a formatowaniem JSONL?
JSONL ma w każdym wierszu jeden kompletny obiekt JSON. SSE ma natomiast opisane etykietami wiersze `id/event/data`, pogrupowane w zdarzenia przez puste wiersze, a tylko część data jest JSON-em. SSE na JSON rozumie te etykiety pól i granice zdarzeń w postaci pustych wierszy, podczas gdy formater JSONL traktowałby każdy wiersz niezależnie.
Czy ten konwerter wysyła moje dane strumienia?
Nie. Parsowanie i formatowanie działają w całości w Twojej przeglądarce, więc dane push, tokeny i treści rozmów nigdy nie opuszczają Twojego komputera.
Słownik
- SSE
- Server-Sent Events, standard jednokierunkowego strumieniowego wypychania z serwera do klienta przez HTTP.
- text/event-stream
- Typ mediów MIME treści odpowiedzi SSE, zawierający wiersze pól oddzielone pustymi wierszami.
- Blok zdarzenia
- Grupa kolejnych niepustych wierszy pól, które razem opisują jedno wypchnięte zdarzenie, zakończone pustym wierszem.
- pole data
- Pole SSE niosące ładunek zdarzenia; wiele wierszy danych w jednym zdarzeniu jest łączonych znakiem nowej linii i zazwyczaj jest JSON-em.
- pole event
- Opcjonalne pole nazywające typ zdarzenia; gdy go brakuje, przeglądarka dysponuje nim jako rodzajowym zdarzeniem „message”.
- pole id
- Opcjonalna wartość last-event-id używana do wznawiania strumienia; ten konwerter emituje numeryczne id jako liczby JSON.
- pole retry
- Opcjonalne pole informujące klienta o czasie oczekiwania na ponowne połączenie w milisekundach; może zawierać wyłącznie cyfry ASCII.
- Wiersz komentarza
- Wiersz zaczynający się od dwukropka, często używany jako heartbeat lub keep-alive, ignorowany podczas budowania zdarzeń.
Authoritative References
- MDN Web DocsMDN: Server-sent events
- HTML Living StandardWHATWG: Server-sent events (format strumienia zdarzeń)
- JSON Compress
- Konwerter CSV na JSON
- JSON na CSV
- JSON Diff
- JSON Escape / Unescape
- Spłaszczanie JSON
- JSON Formatter
- Formatowanie JSONL
- SSE na JSON
- Generator JSON
- Zapytanie JSONPath
- Scal JSON
- Naprawa JSON
- Walidator JSON Schema
- Sortowanie JSON
- JSON Stringify
- JSON do HTML
- JSON do Javy
- JSON na Markdown
- JSON do SQL
- JSON do TOML
- JSON do TypeScript
- XML na JSON
- Konwertuj JSON do XML
- YAML na JSON
- JSON → YAML
- JSON na Go
- JSON na Rust
- JSON to Swift
- JSON na C#
- JSON na C++
- JSON na PHP
- JSON na Python