JSON 포매터
포맷·검증·압축·키 정렬 — 100% 브라우저 내 처리
알아두면 좋은 기술 세부사항
JSON은 RFC 8259로 정의되며, 실무에서 사람을 물 뜨는 세 지점이 있습니다:
- 숫자는 IEEE-754 배정밀도 부동소수점 — 2⁵³를 넘는 정수(예: 9007199254740993)는 JavaScript 기반 파서에서 조용히 정밀도를 잃습니다. API의 긴 ID가 문자열로 오는 이유입니다.
- 중복 키는 표준이 금지하지 않습니다; 파서들은 보통 마지막 값을 남기고, 이 포매터도 같습니다.
- 검증은 첫 문법 오류의 정확한 행·열을 알려주고 멈춥니다 — 고치고 다시 실행하세요.
JSON 포맷터란 무엇인가요?
JSON 포매터는 날것 JSON, 흔히 API 응답, 설정 파일, 로그에서 복사한 한 줄을 가져와 사람이 훑어볼 수 있는 들여쓰기 구조로 다시 배열합니다. 이 도구는 선택 들여쓰기 정리, 빈틈없는 한 줄로의 압축, 원문 불변 검증, 선택에 따른 재귀 키 정렬을 수행하고 매번 바이트 크기, 총 키 수, 중첩 깊이를 보고합니다. 분석, 출력, 통계가 모두 브라우저 안에서 동작하므로 실서비스 페이로드나 비밀이 든 설정을 서버로 보내지 않고 붙여넣을 수 있습니다.
한 줄 API 응답에서 읽을 수 있는 구조로
- 2칸, 4칸, Tab 들여쓰기 정리 또는 가장 짧은 합법 한 줄로의 압축
- 검증 전용 모드. 구문을 확인하고 원문에는 손대지 않습니다
- 재귀 키 정렬. 출력 전에 모든 중첩 객체를 알파벳순으로 정렬합니다
- 파서 메시지와 실패 지점의 정확한 행 번호, 열 번호를 담은 오류 보고
- 실행 후 통계로 바이트 크기, 키 총수, 최대 깊이를 표시하고 복사 및 JSON 파일 저장을 지원합니다
효과를 보는 디버깅 장면
- 필드를 향해 클라이언트 코드를 쓰기 전에 중첩 API 응답 읽기
- 부푼 설정 파일을 다듬고 페이로드를 줄여 제한 있는 요청에 맞추기
- 로그 추출 구조 감사하기. 수백 행에 숨은 하나의 빠진 쉼표
큰 페이로드와 중복 키의 주의점
분석은 엄격 JSON을 따르며 끝 쉼표, 주석, 홑따옴표 문자열은 거부됩니다. 중복 객체 키는 JSON 표준대로 마지막 값이 남으며 오류를 기대한 사람을 놀라게 합니다. 깊고 큰 문서는 나무 전체를 훑으므로 조금 시간이 걸릴 수 있습니다. 빈 입력은 검증 대상이 없으므로 그대로 거부됩니다.
개인정보: 붙여넣은 내용은 무엇도 브라우저 탭을 벗어나지 않습니다. 정리와 검증은 완전 로컬이며 민감한 페이로드는 둔 장소에 머뭅니다.
마지막 업데이트 · 2026-09-01
📚 흔한 JSON 오류와 해결법
JSON 파싱 실패의 거의 대부분은 다음 여덟 가지 오류입니다. 표에서 자신의 오류를 찾고 포매터가 하이라이트하는 줄을 수정하세요.
| 메시지 | 원인 | 해결 |
|---|---|---|
| Unexpected token < | 응답이 JSON이 아니라 HTML | 엔드포인트 확인 — 에러 페이지를 파싱 중 |
| Unexpected end of input | 닫는 괄호 누락 | 포매터의 들여쓰기 가이드로 미닫힘 블록 찾기 |
| Unexpected string | 요소 사이 콤마 누락 | 검증기가 가리키는 위치에 콤마 추가 |
| Unexpected token ' | 작은따옴표 사용 | JSON은 큰따옴표 필수 — 모두 교체 |
| Unexpected token , | } 나 ] 앞 trailing comma | 마지막 콤마 제거 |
| Unexpected number | 선행 0(007)이나 16진수(0x1F) | 문자열로 감싸거나 접두어 제거 |
| 중복 키 | 같은 키 두 번 — 뒤것이 조용히 이김 | 하나 이름 변경. 문법상 가능하지만 위험 |
| 보이지 않는 쓰레기 | BOM이나 붙여넣은 공백 | 플레인 텍스트 소스에서 다시 붙여넣기 |
두 가지 추가 상식: JSON엔 주석 문법이 없습니다(JSONC가 확장 — VS Code 설정이 그것). 숫자엔 선행 0과 16진수 표기가 불가. 전부 브라우저에서 로컬 실행 — JSON이 맞는 형식인지 확신 없으면 형식 비교를 읽어보세요.
마지막 업데이트 · 2026-09-01
에디터 플러그인 대신 이것을 쓰는 이유
정렬·포맷·측정
원본 JSON을 두 칸, 네 칸 또는 탭 들여쓰기로 다듬고, 깊은 키 정렬을 켜고, 실행 후 상태 줄에서 바이트 수, 키 수, 중첩 깊이를 바로 확인할 수 있습니다.
오류 위치를 정확히 표시
검증은 첫 번째 구문 오류의 정확한 줄과 열을 알려주므로 중첩 객체 깊숙이 빠진 쉼표도 막연한 파싱 실패 대신 바로 수정 지점을 가리킵니다.
축소·복사·다운로드
축소 모드는 같은 문서를 한 줄로 접어 가벼운 페이로드로 만들며, 이후 복사하거나 formatted.json 파일로 저장할 수 있습니다.
자주 묻는 질문
JSON이 서버에 업로드되나요?⌄
아니요. 포맷, 검증, 압축 모두 JavaScript로 브라우저 안에서 실행됩니다. 데이터가 기기를 떠나지 않으므로 API 키, 고객 데이터 등 민감한 페이로드에도 안전합니다.
JSON 문법 오류를 어떻게 찾나요?⌄
검증(또는 포맷)을 누르세요. JSON이 잘못됐다면 파서 메시지와 첫 오류의 정확한 행·열을 보여 주어 바로 문제로 갈 수 있습니다 — 뒤에 붙은 쉼표, 작은따옴표, 따옴표 없는 키가 가장 흔한 원인입니다.
'키 정렬'은 무엇을 하나요?⌄
출력 전에 모든 객체의 키를 재귀적으로 알파벳순 정렬합니다. 정렬된 JSON은 코드 리뷰에서 비교하기 쉽고, 캐싱과 해싱에 안정적인 출력을 만듭니다.
긴 ID의 마지막 자리가 포맷 후 바뀌는 이유는?⌄
포맷팅 때문이 아니라 텍스트가 JavaScript 숫자로 변환되는 순간 때문입니다. 2⁵³ ≈ 9×10¹⁵을 넘으면 배정밀도 가수 범위를 벗어나 끝자리가 반올림됩니다. 그런 값은 JSON에서 따옴표 붙은 문자열로 보관하세요.