JSON·JSONL 파서 / 포맷터

JSON 파서·포맷터란?

JSON(JavaScript Object Notation)은 데이터를 {"key": "value"} 형태로 표현하는 가장 널리 쓰이는 교환 포맷입니다. API 응답, 설정 파일, 로그 등 개발 현장에서 수시로 접하게 되는데, 한 줄로 압축된 JSON은 사람이 읽기 어렵고 오타 하나로 파싱이 실패할 수 있습니다.

이 JSON 파서는 입력한 JSON을 실시간으로 검증하고, 보기 좋게 들여쓰기(pretty print)하거나 반대로 한 줄로 압축(minify)합니다. 문법 하이라이트로 문자열·숫자·불리언·null을 색상으로 구분해 한눈에 확인할 수 있고, 오류가 있을 때는 오류 위치(라인·칼럼)를 알려줍니다.

이 도구의 기능

• 실시간 검증: 타이핑하는 동안 자동 파싱 (150ms 디바운스)
• 접기/펼치기 트리뷰: 중첩 객체·배열을 +/− 버튼으로 자유롭게 탐색
• 포맷 / 한 줄로: 2/4 스페이스 또는 탭 들여쓰기 선택, 또는 공백 제거한 압축 모드
• 오류 위치 표시: "line 7, col 12" 형태로 구체적 위치 안내
• 자동 복구 (Lenient Mode): 문자열 안 제어문자, 줄바꿈으로 끊긴 토큰, 후행 쉼표, 주석 등을 자동 정리 후 파싱
• 복구 하이라이트: 자동 복구된 값을 🟥 빨간 테두리로 표시해 어느 부분이 수정됐는지 한눈에 확인
• 문법 하이라이트: 키(보라), 문자열(초록), 숫자(파랑), 불리언(주황), null(회색)
• 복사 / JSON 파일 다운로드: 현재 들여쓰기로 클립보드에 복사하거나 .json 파일로 저장
• 예시 로드: 샘플 JSON으로 즉시 테스트
• JSONL 자동 인식: .jsonl 파일을 줄 번호가 붙은 객체 목록으로 표시

JSONL(JSON Lines) 지원

JSONL(JSON Lines, 확장자 .jsonl·.ndjson)은 한 줄에 JSON 객체를 하나씩 담는 형식으로, ChatGPT·Claude 같은 AI 모델의 학습 데이터셋과 서버 로그 파일에 널리 쓰입니다. 이 파서는 입력이 JSONL이면 자동으로 감지해 줄 번호가 붙은 객체 목록으로 보여주고, 전체 객체 개수를 표시합니다. .jsonl 파일을 입력란에 끌어다 놓으면 바로 파싱되며, 복사·다운로드 시 정식 JSONL 형식(한 줄 1객체)으로 저장됩니다.

자동 복구 (Lenient Mode) 상세

카카오톡·디스코드·채팅 앱에서 복사한 JSON은 화면 줄바꿈 때문에 개행이 끼어들어 일반 파서(JSON.parse)로 실패하는 경우가 많습니다. 이 도구는 다음 4가지 케이스를 자동으로 복구합니다.

1. 문자열 안 제어문자 (\n, \t 등) → 공백으로 치환
2. 토큰 중간 줄바꿈 (숫자 847\n521, 리터럴 fal\nse 등) → 재결합
3. 후행 쉼표 ([1, 2,]) → 제거
4. 주석 (//, /* */) → 제거 (URL 내 //는 보존)

복구가 적용되면 상단에 노란 경고 배너가 뜨고, 결과에는 복구된 값마다 빨간 테두리가 붙어 구분 가능합니다.

브라우저에서 안전하게 처리

입력한 JSON은 서버로 전송되지 않고 브라우저 안에서만 처리됩니다. API 키, 비밀번호, 민감한 고객 데이터가 포함된 JSON을 안전하게 검증·포맷할 수 있습니다.

JSON 문법 빠른 참고

• 키는 반드시 큰따옴표로 감싼 문자열 ('key' 작은따옴표 안 됨)
• 값은 문자열, 숫자, 불리언(true/false), null, 객체 {}, 배열 []
• 배열·객체의 마지막 요소 뒤에 쉼표 금지 (trailing comma)
• 주석 지원 안 함 (//, /* */ 사용 불가)

자주 만나는 파싱 오류

• Unexpected token: 키에 큰따옴표가 없거나, 쉼표·콜론 누락
• Unexpected end of input: 괄호 {} []가 닫히지 않음
• Unexpected string in JSON: trailing comma 또는 키·값 사이 콜론 누락