JSON 포매터
유효한 JSON에 명확한 들여쓰기를 적용하고 중첩 데이터를 확인하며 데이터 모델을 바꾸지 않고 폭을 선택하세요.
JSON을 더 쉽게 읽기
압축된 JSON은 전송에는 편리하지만 개발 중에 확인하기 어렵습니다. 포매터는 객체와 배열을 줄바꿈과 일정한 들여쓰기로 표시하여 계층, 필드, 예상하지 못한 구조를 빠르게 파악하도록 돕습니다.
포맷팅은 표시 방식에 관한 작업입니다. 유효한 문서를 읽기 쉽게 만들지만 값이나 관계를 바꾸지는 않습니다. 원본이 잘못되었다면 따옴표, 쉼표, 괄호를 먼저 고치세요. 공백만 바꿔서는 문법 오류를 고칠 수 없습니다.
JSON 포맷팅의 의미
JSON은 객체, 배열, 문자열, 숫자, 불리언, null로 이루어진 텍스트 형식입니다. 포매터는 이 구조를 읽은 뒤 줄과 공백을 사용해 다시 씁니다. 들여쓰기는 보이는 깊이만 조절하며 필드를 추가하거나 키를 정렬하거나 JSON Schema를 검증하지 않습니다.
표준 JSON에서는 멤버 이름과 문자열에 큰따옴표를 사용합니다. 주석, 마지막 쉼표, NaN, Infinity는 일부 언어 확장에 있지만 표준 문법에는 없습니다. 따라서 익숙한 JavaScript 객체 리터럴이 JSON으로는 실패할 수 있습니다.
포매터 사용 방법
- 원본 입력 칸에 JSON 문서를 붙여 넣거나 입력합니다.
- 두 칸 또는 네 칸처럼 숫자 들여쓰기를 선택합니다.
- 포맷팅을 실행하고 결과를 확인합니다. 오류가 있으면 원본을 고친 뒤 다시 실행합니다.
- 결과를 복사하기 전에 키, 타입, 값을 원본과 비교합니다.
포맷팅 방식
- 먼저 파싱하기
배치하기 전에 입력을 하나의 JSON 값으로 해석해야 합니다. 이렇게 하면 문법 오류와 표시 선택을 구분할 수 있습니다.
- 중첩 값 들여쓰기
깊이가 읽기에 도움이 될 때 객체와 배열을 여러 줄로 나눕니다. 선택한 들여쓰기를 각 수준에서 반복합니다.
- 읽기 쉬운 텍스트 출력
결과는 파싱한 값의 새로운 텍스트 표현입니다. 공백은 바뀔 수 있지만 의도한 구조는 유지됩니다.
읽기 쉬운 결과가 나왔다고 해서 필수 필드나 업무 규칙이 충족되었다는 뜻은 아닙니다.
결과 읽기
결과를 텍스트와 데이터 양쪽으로 확인하세요. 키, 배열 순서, 타입, 문자열 내용이 의도대로인지 살펴봅니다. 추가된 줄바꿈과 공백은 정상적인 포맷 결과입니다.
오류는 원본을 허용된 JSON 문법으로 해석하지 못했다는 뜻입니다. 문제 주변의 쉼표, 따옴표, 괄호, 이스케이프를 확인하세요.
흔한 실수
JavaScript 객체 리터럴, YAML, 주석이 포함된 JSON은 실패할 수 있습니다. 큰따옴표를 사용하고 마지막 쉼표가 없는 표준 JSON을 입력하세요.
들여쓰기는 키를 정렬하거나 필수 필드를 검사하지 않습니다. 그런 작업은 포맷팅과 분리하세요.
제한 사항
인터페이스에서 확인되는 것은 원본 텍스트와 숫자 들여쓰기입니다. JSON Schema, JSON5, 형식 변환, 파일 업로드 지원을 의미하지 않습니다.
큰 문서, 중복 키, 숫자 정밀도, 애플리케이션 규칙은 데이터를 사용하는 시스템에서 별도로 테스트해야 합니다.
Examples
한 줄 객체 포맷팅
한 줄로 된 객체를 어떻게 읽을 수 있나요?
두 칸 들여쓰기로 객체를 제출합니다.
각 속성이 별도 줄에 표시되고 이름과 값은 그대로입니다.
중첩 배열 표시
객체 배열을 어떻게 확인하나요?
두 칸 들여쓰기로 포맷팅을 실행합니다.
괄호와 객체의 경계가 배열의 계층을 보여 줍니다.
네 칸 들여쓰기 선택
더 넓은 들여쓰기는 언제 유용한가요?
네 칸을 선택하고 원본을 포맷팅합니다.
각 중첩 수준이 더 멀리 표시되어 큰 화면에서 읽기 편할 수 있습니다.
빠진 따옴표 찾기
이름을 따옴표로 감싸지 않으면 어떻게 되나요?
원본을 보내고 응답을 확인합니다.
표준 JSON이 아닙니다. 멤버 이름은 큰따옴표 안의 문자열이어야 합니다.
불리언 유지
true가 문자열로 바뀌나요?
객체를 포맷팅하고 타입을 비교합니다.
true는 불리언으로 남고, 따옴표가 있는 yes는 문자열로 남습니다.
null 유지
null은 어떻게 표시되나요?
객체를 포맷팅하고 값을 읽습니다.
null은 명시적인 JSON 값으로 남으며 누락된 속성이나 빈 문자열과 다릅니다.
Frequently asked questions
포맷팅이 JSON도 검증하나요?
원본을 파싱해야 하므로 문법 오류가 결과를 막을 수 있습니다. 하지만 스키마, 필수 필드, 업무 규칙을 검증하지는 않습니다.
값이 바뀌나요?
예상되는 변화는 공백과 줄입니다. 매우 큰 숫자나 중복 키가 있다면 결과를 비교하세요.
작은따옴표를 사용해도 되나요?
표준 JSON에서는 안 됩니다. 이름과 문자열에는 큰따옴표가 필요합니다.
마지막 쉼표가 왜 실패하나요?
일부 확장은 허용하지만 표준 문법은 허용하지 않습니다. 포맷팅 전에 제거하세요.
두 칸과 네 칸 중 무엇을 선택하나요?
프로젝트나 리뷰의 스타일을 따르세요. 가독성은 바뀌지만 데이터 모델은 바뀌지 않습니다.
키가 정렬되나요?
그렇게 가정하지 마세요. 포맷팅은 배치만 정리하며 정렬에는 별도의 문서화된 옵션이 필요합니다.
잘못된 JSON을 고칠 수 있나요?
아니요. 원본의 따옴표, 쉼표, 괄호, 이스케이프를 직접 수정하세요.
포맷팅한 JSON이 더 작아지나요?
대개 그렇지 않습니다. 공백이 추가되기 때문입니다. 압축 JSON은 전송에, 포맷팅된 JSON은 사람이 검토하는 데 적합합니다.