API 응답이 한 줄로 쭉 이어져서 눈으로 읽을 수가 없다. 중괄호와 대괄호가 어디서 시작하고 끝나는지 파악하려면 들여쓰기가 있어야 하는데, 수천 글자짜리 JSON을 손으로 정리할 수는 없다.
JSON이 한 줄로 오는 이유
서버에서 JSON 데이터를 보낼 때는 용량을 줄이기 위해 공백과 줄바꿈을 모두 제거한다. 이걸 minify(압축)라고 한다. 전송 속도에는 좋지만, 사람이 읽기에는 최악이다.
{"name":"홍길동","age":30,"address":{"city":"서울","zip":"06100"}}같은 데이터를 정렬(format)하면 이렇게 바뀐다.
{
"name": "홍길동",
"age": 30,
"address": {
"city": "서울",
"zip": "06100"
}
}JSON 정리에 필요한 기능
- 정렬(Format): 들여쓰기와 줄바꿈을 추가해서 구조를 한눈에 파악할 수 있게 만든다.
- 압축(Minify): 반대로 공백을 전부 제거해서 파일 크기를 줄인다. 배포 시 유용하다.
- 키 정렬: JSON 객체의 키를 알파벳순으로 재배치한다. 두 JSON을 비교할 때 키 순서가 다르면 diff가 제대로 안 나오는데, 정렬하면 해결된다.
- 검증(Validate): 쉼표 누락, 따옴표 불일치 같은 문법 오류를 잡아준다.
TIP JSON에서 가장 흔한 실수는 마지막 항목 뒤에 쉼표를 넣는 것(trailing comma)이다. JavaScript에서는 허용되지만, JSON 표준에서는 문법 오류로 처리된다.
JSON 포맷터 사용법
IDE에 JSON 플러그인을 설치해 쓸 수도 있지만, 빠르게 확인만 하고 싶을 때는 브라우저에서 바로 쓰는 게 편하다. 온라인 JSON 포맷터에 데이터를 붙여넣고 정렬 버튼을 누르면 들여쓰기된 결과가 즉시 나온다. 문법 오류가 있으면 어디가 잘못됐는지 알려주고, 파일 크기, 깊이, 키 개수 같은 통계도 함께 표시된다.
JSON을 눈으로 읽는 일이 잦다면, 정렬 한 번이 디버깅 시간을 확 줄여준다.