SSE to 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

Server-Sent Events(SSE) 푸시 데이터에 특화된 변환 도구입니다. 왼쪽에 원본 id/event/data 블록을 붙여넣으면 오른쪽에 표준 JSON 배열이 즉시 표시되며, 푸시된 각 이벤트가 id·이벤트 이름·파싱된 data 페이로드를 담은 단일 객체가 됩니다.

관련 추천

SSE to 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으로 파싱해 중첩 구조를 보존합니다.

결과는 읽기 쉽고 코드에 복사하거나 다른 캡처와 비교(diff)하거나 다운스트림 도구에 넣기 쉬운 표준 들여쓰기 JSON 배열입니다. 파싱할 수 없는 페이로드는 버려지지 않고 플래그가 지정됩니다.

사용 사례

  • STREAM_CHUNK, CHUNK_DELTA 같은 SSE 이벤트 청크로 도착하는 LLM·AI 에이전트 스트리밍 응답을 디버깅
  • 브라우저 개발자 도구 Network 탭에서 복사한 text/event-stream 응답을 읽기 쉬운 JSON으로 변환
  • 실시간 푸시나 채팅 백엔드에서 오는 하트비트·ack·전체 메시지 이벤트를 점검
  • 캡처한 SSE 푸시 데이터를 JSON 배열로 바꾼 뒤 디버깅용으로 동료와 공유
  • 매 이벤트의 중첩된 data 페이로드를 추출해 펼치기. data: 접두사를 수동으로 지울 필요 없음
  • 녹화한 푸시 스트림을 오프라인에서 재생하고 id 기준 이벤트 순서를 비교
  • JSON 배열을 기대하는 분석·로그·스프레드시트용으로 SSE 이벤트 데이터 준비
  • 프론트엔드와 백엔드 연동 시 서버가 예상한 이벤트 이름과 페이로드 형태로 내보내는지 검증
  • 여러 줄 data 필드를 이벤트 객체당 하나의 파싱된 값으로 평탄화
  • 프록시·게이트웨이·curl 출력에서 나온 SSE 추적을 구조화되고 접기 좋은 형태로 점검
  • SSE 전송 형식을 재사용하는 Webhook식 또는 메시지 큐 이벤트 스트림을 JSON으로 변환
  • id·event·data가 JSON 객체로 어떻게 매핑되는지 보면서 Server-Sent Events 전송 형식을 학습

이용 방법

  1. 원본 SSE 스트림을 왼쪽 textarea에 붙여넣습니다. id/event/data 줄과 이벤트 사이의 빈 줄을 포함하세요
  2. 오른쪽이 자동으로 갱신되며 이벤트 하나당 객체 하나인 JSON 배열이 표시됩니다
  3. data 페이로드가 유효한 JSON이 아니거나 필드가 잘못 보이면 경고 패널을 확인하세요
  4. 복사로 전체 JSON 배열을 복사하거나, 먼저 샘플로 내장 예제를 불러올 수 있습니다

주요 기능

  • 원본 SSE 이벤트 스트림을 표준 JSON 배열로 변환. 푸시된 이벤트 하나당 객체 하나를 생성
  • Server-Sent Events 디스패치 모델에 따라 빈 줄로 줄을 이벤트 단위로 묶음
  • 각 줄을 field: value로 파싱하고 콜론 뒤의 공백 한 칸을 제거
  • 모든 data 페이로드를 JSON.parse로 파싱해 중첩 페이로드를 이스케이프 문자열이 아닌 실제 객체로 만듦
  • id·event·data 키 순서를 안정적으로 유지하고 숫자 id는 JSON 숫자로 변환
  • 여러 줄에 걸친 data 필드, 콜론으로 시작하는 주석 줄, 마지막 빈 줄이 없는 스트림도 지원
  • 유효하지 않은 data 페이로드나 알 수 없거나 잘못된 필드를 블록 번호·줄 번호와 함께 알림
  • 분할된 textarea 입력과 JSON 미리보기 레이아웃. 샘플·지우기·복사·이벤트 통계 제공. 모든 처리는 브라우저에서 완료

SSE to JSON vs JSONL 포맷터 vs JSON 포맷터

이 도구들은 서로 다른 입력 형태를 다룹니다. 올바른 도구를 고르면 접두사를 손으로 제거하고 배열로 감싸는 수고를 피할 수 있습니다.

도구입력 형태주요 강점사용 상황
SSE to JSON빈 줄로 나뉜 id/event/data 블록SSE 필드를 이해하고 각 data 페이로드를 파싱서버 푸시 스트림, text/event-stream, AI 스트리밍 청크
JSONL 포맷터한 줄에 완전한 JSON 객체 하나각 줄을 독립적으로 검증·정렬NDJSON 로그, 보관 이벤트, 줄 구분 내보내기
JSON 포맷터완전한 JSON 객체 또는 배열 하나단일 JSON 문서 전체를 정렬API 응답, 설정 파일, 단발성 페이로드

Best Practices

스트림을 복사할 때 이벤트 사이의 빈 줄을 유지하세요

빈 줄이 바로 SSE 이벤트를 다음 이벤트와 갈라놓는 경계입니다. 복사하면서 빈 줄을 없애면 서로 다른 이벤트가 하나의 블록으로 합쳐져 변환 결과가 원래 디스패치 순서와 더 이상 일치하지 않게 됩니다.

경고의 블록·줄 번호로 문제 위치로 바로 이동하세요

data 페이로드 파싱에 실패하면 경고가 이벤트 블록과 해당 줄을 지명합니다. 그 블록을 가까운 유효 이벤트와 비교하면 잘린 중괄호, 빠진 따옴표, 이어 붙은 청크를 빠르게 찾을 수 있습니다.

JSON으로 파싱되는 것은 data 필드뿐임을 기억하세요

id, event, retry 필드는 SSE 전송 메타데이터이며 스칼라 값으로 남습니다. 변환 도구가 이벤트 이름이나 id 안의 JSON까지 파싱하리라 기대하지 마세요. 구조화된 내용은 data에 둬야 합니다.

전체 메시지를 변환하기 전에 부분 스트리밍 청크를 모으세요

많은 AI 스트림은 하나의 메시지를 구성하는 작은 STREAM_CHUNK 이벤트를 다수 보냅니다. 먼저 캡처 전체를 변환해 모든 청크를 배열 항목으로 본 뒤, 필요하다면 애플리케이션 코드에서 청크 페이로드를 합쳐 최종 메시지를 얻으세요.

변환된 JSON을 공유하기 전에 민감한 페이로드를 정화하세요

변환은 로컬에서 이뤄지지만 JSON 배열을 티켓이나 채팅에 복사하는 순간 기기 밖으로 나갑니다. 공유 전에 출력에서 토큰, 사용자 id, 사적인 대화 텍스트를 제거하세요.

자주 묻는 질문

SSE(Server-Sent Events)란 무엇인가요?

SSE는 서버가 `text/event-stream` 콘텐츠 타입을 사용해 HTTP를 통해 브라우저로 텍스트 이벤트를 푸시하는 표준 방식입니다. 각 이벤트는 `id`, `event`, `data` 같은 텍스트 줄로 구성되며 이벤트끼리는 빈 줄로 구분됩니다.

이 도구는 스트림을 어떻게 이벤트로 나누나요?

SSE 디스패치 모델을 따릅니다. 입력을 줄 단위로 나누고 연속된 비어 있지 않은 줄이 하나의 이벤트 블록을 이루며, 빈 줄이 해당 블록을 새 이벤트로 디스패치합니다. 마지막 빈 줄이 없는 마지막 블록도 그대로 내보내며 콜론으로 시작하는 주석 줄은 무시합니다.

출력 JSON은 어떻게 생겼나요?

결과는 하나의 JSON 배열입니다. 입력 이벤트 하나가 하나의 객체가 되어 존재했던 필드가 id·event·data 안정 순서로 들어갑니다. `data` 텍스트는 JSON.parse로 파싱되므로 `data: {"a":1}` 같은 페이로드는 이스케이프 문자열이 아닌 중첩 객체 `"data": {"a":1}`가 됩니다.

출력에서 id가 숫자인 이유는 무엇인가요?

기술적으로 SSE id는 문자열이지만 실제 푸시 스트림은 거의 항상 `id: 0` 같은 숫자 id를 사용합니다. id가 숫자로만 이루어진 경우 변환 도구는 이를 JSON 숫자로 내보내고, 그 외 id는 문자열로 유지합니다.

data가 여러 줄에 걸치면 어떻게 되나요?

SSE 사양에 따라 한 이벤트 안의 여러 `data:` 줄은 개행 문자로 이어 붙여진 뒤 하나의 값으로 파싱됩니다. 이어 붙인 텍스트가 유효한 JSON이 아니면 변환 도구는 원본 텍스트를 보관하고 경고를 추가해 아무것도 조용히 버려지지 않게 합니다.

data 페이로드가 유효한 JSON이 아니면 어떻게 되나요?

변환 전체가 실패하는 대신 해당 이벤트는 원본 data를 JSON 문자열로 보관하고, 페이지가 블록 번호와 파서 오류 메시지를 담은 경고를 표시합니다. 주변의 유효한 이벤트는 여전히 정상 변환됩니다.

SSE to JSON과 JSONL 포맷터의 차이는 무엇인가요?

JSONL은 매 줄마다 완전한 JSON 객체가 하나씩 있습니다. 반면 SSE는 빈 줄로 이벤트 단위로 묶인 `id/event/data` 레이블 줄을 가지며 JSON인 부분은 data뿐입니다. SSE to JSON은 그 필드 레이블과 빈 줄 이벤트 경계를 이해하지만, JSONL 포맷터는 모든 줄을 독립적으로 취급합니다.

이 변환기는 제 스트림 데이터를 업로드하나요?

아니요. 파싱과 포맷팅은 모두 브라우저에서 실행되므로 푸시 데이터, 토큰, 대화 내용이 사용자의 기기 밖으로 나가지 않습니다.

용어집

SSE
Server-Sent Events의 약자로, HTTP를 통한 서버에서 클라이언트로의 단방향 푸시 스트리밍 표준.
text/event-stream
빈 줄로 구분된 필드 줄을 담는 SSE 응답 본문의 MIME 미디어 타입.
이벤트 블록
연속된 비어 있지 않은 필드 줄들의 묶음으로, 빈 줄로 끝나며 하나의 푸시 이벤트를 기술함.
data 필드
이벤트 페이로드를 담당하는 SSE 필드. 한 이벤트의 여러 data 줄은 개행으로 이어 붙여지며 일반적으로 JSON임.
event 필드
이벤트 타입 이름을 지정하는 선택 필드. 생략되면 브라우저는 이를 범용 'message' 이벤트로 디스패치함.
id 필드
스트림 재개에 쓰이는 선택 last-event-id 값. 이 변환기는 숫자 id를 JSON 숫자로 내보냄.
retry 필드
재연결 대기 시간을 밀리초로 클라이언트에 알리는 선택 필드. ASCII 숫자만 포함해야 함.
주석 줄
콜론으로 시작하는 줄. 하트비트나 킵얼라이브로 자주 쓰이며 이벤트 구성 시 무시됨.

Authoritative References