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

Узкоспециализированный конвертер для 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

Как использовать

  1. Вставьте сырой поток SSE в левое текстовое поле: строки id/event/data и пустая строка между событиями
  2. Справа всё обновляется автоматически и показывается массив JSON с одним объектом на событие
  3. Загляните в панель предупреждений, если полезная нагрузка data не является корректным JSON либо поле выглядит некорректно
  4. Используйте «Копировать», чтобы скопировать весь массив 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