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.
Узкоспециализированный конвертер для push-данных Server-Sent Events (SSE). Вставьте слева сырые блоки id/event/data, а справа мгновенно отрисуется стандартный массив JSON, где каждое отправленное событие становится отдельным объектом со своим id, именем события и разобранной полезной нагрузкой.
Похожие
Что такое конвертация SSE в JSON?
Server-Sent Events (SSE) — это однонаправленный потоковый протокол, в котором сервер записывает текстовые события UTF-8 в HTTP-ответе типа `text/event-stream`. На проводе каждое событие — это последовательность строк полей вроде `id: 1`, `event: MESSAGE` и `data: {...}`, а пустая строка отмечает конец этого события.
Сырой SSE удобен для передачи, но неудобен для чтения и отладки. Имена полей повторяются в каждом событии, полезная нагрузка JSON спрятана за префиксом `data:`, а длинные потоки сливаются в стену текста. Конвертировать SSE в JSON означает нормализовать каждое событие в обычный объект и собрать все события в один массив JSON.
Этот конвертер следует правилам интерпретации потока событий: он разбивает по завершениям строк, трактует пустую строку как границу диспетчеризации, удаляет ровно один необязательный пробел после двоеточия поля, склеивает повторяющиеся строки data переводами строк и игнорирует комментарии с двоеточием. Затем он разбирает каждую полезную нагрузку data как JSON, сохраняя вложенные структуры.
Результат — стандартный, с отступами массив JSON, который легко читать, копировать в код, сравнивать с другим перехватом или скармливать дальше в инструменты, при этом каждая неразбираемая полезная нагрузка помечается, а не отбрасывается.
Варианты использования
- Отладка потоковых ответов LLM или ИИ-агентов, которые приходят частями событий SSE вроде STREAM_CHUNK или CHUNK_DELTA
- Превратить скопированный из вкладки «Сеть» инструментов разработчика в браузере ответ text/event-stream в читаемый JSON
- Осмотр событий heartbeat, ack и полного сообщения от бэкенда реального времени или чата
- Превратить перехваченные push-данные SSE в массив JSON перед тем, как поделиться ими с коллегой для отладки
- Извлечь и развернуть вложенную полезную нагрузку data каждого события, не удаляя префиксы data: вручную
- Воспроизвести записанный push-поток в офлайне и сравнить порядок событий по id
- Подготовить данные событий SSE для аналитики, логов или таблиц, которые ожидают массив JSON
- Проверить при интеграции фронтенда с бэкендом, что сервер отдаёт ожидаемые имена событий и форму полезной нагрузки
- Развернуть многострочные поля data в одно разобранное значение на объект события
- Ослеживать следы SSE от прокси, шлюзов или вывода curl в структурированном, удобном для сворачивания виде
- Конвертировать потоки событий в стиле webhook или очереди сообщений, переиспользующие проводной формат SSE, в JSON
- Изучить проводной формат Server-Sent Events, видя, как id, event и data отображаются в объекты JSON
Как использовать
- Вставьте сырой поток SSE в левое текстовое поле: строки id/event/data и пустая строка между событиями
- Справа всё обновляется автоматически и показывается массив JSON с одним объектом на событие
- Загляните в панель предупреждений, если полезная нагрузка data не является корректным JSON либо поле выглядит некорректно
- Используйте «Копировать», чтобы скопировать весь массив JSON, или «Пример», чтобы сначала загрузить встроенный пример
Функции
- Преобразует сырой поток событий SSE в стандартный массив JSON — по одному объекту на каждое отправленное событие
- Группирует строки в события по пустой строке, следуя модели диспетчеризации Server-Sent Events
- Разбирает каждое поле как поле: значение и удаляет один пробел после двоеточия
- Разбирает каждую полезную нагрузку data через JSON.parse, поэтому вложенные данные становятся настоящими объектами, а не экранированными строками
- Сохраняет стабильный порядок ключей id, event и data и превращает числовые id в числа JSON
- Поддерживает многострочные поля data, строки-комментарии, начинающиеся с двоеточия, и потоки без завершающей пустой строки
- Сообщает о недопустимых полезных нагрузках data и неизвестных или некорректно оформленных полях с номерами блока и строки
- Разделённый макет из текстового поля ввода и предпросмотра JSON с примером, очисткой, копированием и статистикой событий; работает полностью в браузере
SSE в JSON vs форматирование JSONL vs форматирование JSON
Эти инструменты работают с разной формой входных данных. Правильный выбор избавляет от ручного снятия префиксов и оборачивания в массивы.
| Инструмент | Форма ввода | Ключевая возможность | Когда применять |
|---|---|---|---|
| SSE в JSON | Блоки id/event/data, разделённые пустыми строками | Понимает поля SSE и разбирает каждую полезную нагрузку data | Серверные push-потоки, text/event-stream, потоковые чанки ИИ |
| Форматирование JSONL | Один полный объект JSON в строке | Проверяет и форматирует каждую строку независимо | Логи NDJSON, архивные события, построчные экспорты |
| Форматирование JSON | Один полный объект или массив JSON | Сделать читаемым единый полный документ JSON | Ответы API, конфигурационные файлы, разовые payload |
Best Practices
Сохраняйте пустую строку между событиями при копировании потока
Именно пустая строка отделяет одно событие SSE от следующего. Если при копировании убрать пустые строки, разные события могут слиться в один блок, и конвертация уже не будет соответствовать исходному порядку диспетчеризации.
Используйте номера блока и строки в предупреждениях, чтобы перепрыгнуть к проблеме
Когда полезная нагрузка data не разбирается, в предупреждении назван блок события и виновная строка. Сравните этот блок с соседним корректным событием, чтобы заметить обрезанную скобку, пропущенную кавычку или склеенные чанки.
Помните, что как JSON разбирается только поле data
Поля id, event и retry — это транспортные метаданные SSE и остаются скалярными значениями. Не ждите, что конвертер разберёт JSON, встречающийся в имени события или id; структурированное содержимое принадлежит data.
Собирайте частичные потоковые чанки до конвертации полного сообщения
Многие потоки ИИ шлют множество мелких событий STREAM_CHUNK, из которых собирается одно сообщение. Сначала сконвертируйте весь перехват, чтобы увидеть каждый чанк как элемент массива, а потом склейте payload чанков в коде приложения, если нужно финальное сообщение.
Очищайте чувствительные payload перед тем, как делиться сконвертированным JSON
Конвертация локальна, но как только вы скопируете массив JSON в тикет или чат, он покинет вашу машину. Удалите токены, идентификаторы пользователей и приватный текст переписки из вывода перед тем, как поделиться.
Часто задаваемые вопросы
Что такое 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 технически строки, но реальные push-потоки почти всегда используют числовые id вроде `id: 0`. Если id состоит только из цифр, конвертер выводит его как число JSON; любой другой id остаётся строкой.
Что происходит, когда data занимает несколько строк?
Согласно спецификации SSE, несколько строк `data:` внутри одного события объединяются символом перевода строки, прежде чем разбираться как одно значение. Если объединённый текст не является корректным JSON, конвертер сохраняет исходный текст и добавляет предупреждение, чтобы ничего не потерялось молча.
Что, если полезная нагрузка data не является корректным JSON?
Вместо того чтобы провалить всю конвертацию, это событие сохраняет исходные данные как строку JSON, а на странице показывается предупреждение с номером блока и сообщением об ошибке парсера. Соседние корректные события по-прежнему конвертируются нормально.
В чём разница между SSE в JSON и форматированием JSONL?
В JSONL каждая строка — это один полный объект JSON. У SSE же есть помеченные строки `id/event/data`, сгруппированные в события пустыми строками, и JSON представляет собой только часть data. SSE в JSON понимает эти метки полей и границы событий по пустым строкам, тогда как форматтер JSONL рассматривал бы каждую строку независимо.
Загружает ли этот конвертер мои данные потока?
Нет. Разбор и форматирование выполняются целиком в вашем браузере, поэтому push-данные, токены и содержимое переписки никогда не покидают ваш компьютер.
Глоссарий
- SSE
- Server-Sent Events, стандарт однонаправленной потоковой отправки с сервера на клиент по HTTP.
- text/event-stream
- Медиатип MIME тела ответа SSE, содержащий строки полей, разделённые пустыми строками.
- Блок события
- Группа подряд идущих непустых строк полей, которые вместе описывают одно отправленное событие и завершаются пустой строкой.
- поле data
- Поле SSE, несущее полезную нагрузку события; несколько строк data в одном событии объединяются переводом строки и обычно являются JSON.
- поле event
- Необязательное поле, задающее имя типа события; если его нет, браузер отправляет событие как обычное «message».
- поле id
- Необязательное значение last-event-id, используемое для возобновления потока; этот конвертер выводит числовые id как числа JSON.
- поле retry
- Необязательное поле, сообщающее клиенту паузу переподключения в миллисекундах; должно содержать только цифры ASCII.
- Строка-комментарий
- Строка, начинающаяся с двоеточия, часто используемая как heartbeat или keep-alive и игнорируемая при построении событий.
Authoritative References
- MDN Web DocsMDN: Server-sent events
- HTML Living StandardWHATWG: Server-sent events (формат потока событий)
- JSON Compress
- 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