JSON 포매터 사용법
원본 JSON 칸에 API 응답이나 설정 내용을 붙여 넣으면 문법을 검사하고 결과 칸에 2칸 들여쓰기 형식으로 정렬합니다. 유효한 데이터이면 최상위 값이 객체인지 배열인지도 알려 줍니다. “결과 복사” 버튼을 누르면 정렬된 내용을 클립보드에 복사할 수 있습니다. 입력과 정리는 현재 브라우저에서만 처리하며 서버로 JSON을 전송하지 않습니다.
민감한 토큰이나 개인정보가 든 응답을 다룰 때도 네트워크 전송은 없지만, 공유 컴퓨터의 클립보드 기록이나 브라우저 확장 프로그램은 별도 영역입니다. 작업이 끝나면 입력을 지우고 보안 정책이 있는 조직에서는 승인된 개발 환경을 사용하세요.
JSON 문법 검사와 정렬 원리
브라우저 표준 함수인 JSON.parse로 문자열을 자바스크립트 값으로 읽습니다. 문법이 맞으면 JSON.stringify를 사용해 두 칸 들여쓰기 문자열로 다시 만듭니다. 중괄호는 객체, 대괄호는 배열을 나타내며 키와 문자열은 반드시 큰따옴표로 감싸야 합니다. 마지막 항목 뒤의 쉼표, 작은따옴표, 주석은 표준 JSON에서 허용되지 않습니다.
이 과정은 키 순서를 보기 좋게 재배치하는 정렬(sort)이 아니라 원래 순서를 유지하며 줄바꿈과 들여쓰기만 추가하는 포매팅입니다. 중복 키가 있으면 파서가 마지막 값을 남길 수 있고, 아주 큰 정수는 자바스크립트의 안전 정수 범위를 넘어 정밀도가 손실될 수 있습니다. 손실 없이 원문을 보존해야 하는 대용량 데이터나 금융 식별자는 전용 파서를 사용하세요.
자주 만나는 JSON 오류
가장 흔한 오류는 키를 따옴표로 감싸지 않은 경우, 문자열에 큰따옴표를 이스케이프하지 않은 경우, 마지막 항목 뒤에 쉼표를 붙인 경우입니다. 줄바꿈을 문자열 안에 넣으려면 실제 줄바꿈 대신 \n을 사용해야 합니다. JSON은 JavaScript 객체 표기와 비슷하지만 함수, undefined, NaN, Infinity, 날짜 객체를 직접 표현하지 못합니다.
오류 메시지는 브라우저 엔진이 발견한 위치를 바탕으로 표시됩니다. 실제 원인은 표시 지점보다 앞에 있는 닫히지 않은 따옴표나 괄호일 수 있으므로 그 주변부터 확인하세요. API가 HTML 오류 페이지를 반환했는데 JSON으로 파싱하려는 경우도 많습니다. 첫 글자가 <라면 응답 상태와 콘텐츠 타입을 먼저 살펴보세요.
정렬된 JSON은 코드 리뷰와 로그 분석에는 읽기 좋지만 공백과 줄바꿈 때문에 전송 크기가 커집니다. API 요청이나 배포 파일에 넣을 때는 필요하면 다시 압축된 한 줄 형식으로 만들어야 합니다. 반대로 버전 관리 저장소에서는 사람이 변경점을 읽을 수 있도록 일관된 들여쓰기 규칙을 유지하는 편이 좋습니다. 이 도구는 2칸 들여쓰기만 제공하며 프로젝트 포매터 설정을 바꾸지 않습니다.
자주 묻는 질문
JSON 키에 작은따옴표를 써도 되나요?
표준 JSON에서는 안 됩니다. 키와 문자열 모두 큰따옴표를 사용해야 합니다.
키 순서를 알파벳순으로 바꾸나요?
아닙니다. 입력의 키 순서를 유지하고 들여쓰기와 줄바꿈만 정리합니다.
주석이 들어간 JSON도 되나요?
표준 JSON에는 주석이 없어 오류가 납니다. JSONC 파일은 주석을 제거한 뒤 검사하세요.
입력 데이터가 서버에 전송되나요?
아닙니다. 브라우저의 기본 JSON 함수로만 처리하며 원문을 저장하거나 전송하지 않습니다.