API 응답을 확인하려고 콘솔에 찍었는데 JSON이 한 줄로 쭉 이어져 나온다. 중괄호와 대괄호가 엉켜 있어서 어디가 어디인지 구분이 안 된다. 들여쓰기 없는 JSON을 눈으로 읽는 건 사실상 불가능하다.
JSON 포맷팅이 필요한 순간
- API 응답 데이터를 눈으로 확인해야 할 때
- 설정 파일(config.json)에 오류가 있는데 어디가 잘못된지 모를 때
- 다른 개발자에게 JSON 데이터를 보내야 하는데 읽기 쉽게 정리하고 싶을 때
- 배포 전에 JSON을 한 줄로 압축해서 용량을 줄이고 싶을 때
정렬과 검증의 차이
정렬(포맷팅)은 들여쓰기와 줄바꿈을 넣어서 구조를 시각적으로 보기 좋게 만드는 것이다. 검증(validation)은 JSON 문법이 올바른지 확인하는 것이다. 쉼표를 빠뜨리거나 따옴표가 짝이 안 맞으면 파싱 에러가 나는데, 어디서 잘못됐는지 찾는 게 검증의 핵심이다.
| 기능 | 설명 | 활용 상황 |
|---|---|---|
| 정렬(포맷팅) | 들여쓰기, 줄바꿈 추가 | API 응답 확인, 코드 리뷰 |
| 검증 | 문법 오류 검출 | 설정 파일 디버깅 |
| 압축(미니파이) | 공백, 줄바꿈 제거 | 배포 전 용량 최소화 |
| 키 정렬 | 키를 알파벳순 재배치 | JSON 비교, 일관성 유지 |
브라우저에서 바로 처리하기
온라인 JSON 포맷터에 JSON을 붙여넣으면 정렬, 검증, 압축이 한 화면에서 된다. 문법 오류가 있으면 어느 위치에서 잘못됐는지 알려주고, 파일 크기, 깊이, 키 개수 같은 통계 정보도 표시된다. 키를 알파벳순으로 정렬하는 기능도 있어서, 두 JSON을 비교할 때 먼저 키 정렬을 해두면 diff가 훨씬 깔끔해진다.
TIP JSON에서 가장 흔한 실수는 마지막 항목 뒤에 쉼표를 넣는 것(trailing comma)이다. JavaScript 객체에서는 허용되지만 JSON 표준에서는 에러다. 포맷터에 넣으면 이런 실수를 바로 잡아준다.
한 줄짜리 JSON과 씨름하는 시간을 줄이려면 포맷터 하나 즐겨찾기 해두면 된다. 복사, 붙여넣기, 한 번 클릭이면 끝이다.