API 응답을 콘솔에 찍었더니 한 줄짜리 문자열이 쏟아진다. 중괄호와 대괄호가 수백 개 이어져 있는데, 이 상태로는 어디가 어떤 데이터인지 파악이 불가능하다. 들여쓰기 하나만 넣어도 구조가 보인다.
JSON 포매터가 하는 일
- 정렬(Format)
- 한 줄로 압축된 JSON에 들여쓰기와 줄바꿈을 넣어 읽기 쉽게 만든다. 들여쓰기는 2칸, 4칸, 탭 중 선택할 수 있다.
- 검증(Validate)
- JSON 문법이 올바른지 확인한다. 콤마 하나 빠져도, 따옴표가 안 닫혀도 오류 위치를 정확히 알려준다.
- 압축(Minify)
- 공백과 줄바꿈을 전부 제거해서 용량을 최소화한다. API 전송이나 설정 파일 저장 시 유용하다.
- 키 정렬(Sort Keys)
- JSON 객체의 키를 알파벳 순서로 정렬한다. 두 JSON을 비교(diff)할 때 키 순서가 다르면 차이를 찾기 어려운데, 정렬하면 깔끔하게 비교된다.
실무에서 자주 쓰는 상황
API 디버깅
서버에서 받은 응답을 JSON 포매터에 붙여넣으면 구조가 한눈에 보인다. 중첩된 객체 안에 원하는 값이 어디 있는지 빠르게 찾을 수 있다. 통계(파일 크기, 깊이, 키 개수)도 자동으로 나와서 데이터 규모를 파악하기 좋다.
설정 파일 편집
package.json, tsconfig.json 같은 설정 파일을 수동으로 편집할 때 콤마 하나 빠뜨리면 프로젝트가 안 돌아간다. 저장 전에 검증 기능으로 한 번 돌리면 문법 오류를 미리 잡을 수 있다.
데이터 전송 최적화
보기 좋게 정렬된 JSON은 용량이 크다. 네트워크로 전송할 때는 압축해서 보내는 게 효율적이다. 들여쓰기와 줄바꿈만 빼도 용량이 20~30% 줄어든다.
TIP JSON에서 가장 흔한 문법 오류는 마지막 항목 뒤에 붙은 쉼표(trailing comma)다. JavaScript에서는 허용되지만 JSON 표준에서는 오류로 처리된다.
JSON과 비슷하지만 다른 형식들
- YAML: 들여쓰기 기반, 설정 파일에서 JSON 대신 쓰이는 경우가 많다
- XML: 태그 기반, 레거시 시스템에서 여전히 사용
- CSV: 표 형태 데이터에 적합, 중첩 구조 표현 불가
JSON은 웹 개발에서 사실상 표준이다. 제대로 읽고 쓸 줄 알면 API 연동이나 데이터 처리에서 시간을 아낄 수 있다.