검토하기 전에 JSON 포맷 및 검사하기
API 페이로드와 설정 파일을 위한 리뷰어 루틴: 먼저 보기 좋게 인쇄하고, 구조를 트리로 검사하고, 두 문서를 결정적으로 비교하세요. 데이터는 어디에도 보내지 않습니다.
정밀도와 순서 확인
개인 데이터를 사용하기 전에 이 합성 입력으로 실제 결과를 확인하세요.
JSON 트리 뷰어에 예제를 붙여 넣고 압축 보기로 전환하세요. 출력은 이 텍스트와 정확히 같아야 합니다.
{"id":9007199254740993,"2":"b","1":"a"}
정수의 끝은 993이고 키 2가 키 1 앞에 있어야 합니다. {"name":}의 오류 위치는 1행 9열입니다. 제한은 256 KiB, 깊이 40, 노드 10,000개이며 중복 키와 예약 키는 거부합니다.
정밀도와 순서 확인왜 포맷이 먼저인가
압축된 JSON은 기계를 위한 것입니다. 한 줄, 들여쓰기 없음, 키 순서는 직렬화기 마음. 그 벽을 눈으로 검토하게 하면 삭제된 권한, 뒤집힌 플래그, 예상치 못한 엔드포인트가 빠져나갑니다.
포맷터는 당신이 가진 가장 저렴한 유효성 검사이기도 합니다. 파싱에 실패하는 문서는 프로덕션에서도 제대로 동작하지 않았을 것이고, 그 사실을 배포 로그가 아니라 검토 탭에서 알게 되는 편이 훨씬 낫습니다.
- 가독성만서식 지정은 파싱된 JSON 값을 보존하지만 이스케이프 표기와 숫자 표기를 정규화할 수 있습니다. 바이트 단위 텍스트보다 의미를 비교하고, 서명되었거나 원본 바이트에 민감한 파일은 원본을 보관하세요.
- 깊이가 신호일관된 들여쓰기는 중첩 깊이를 한눈에 드러냅니다. 설정 실수는 깊이에 숨는 법이고, 한 단계 깊게 놓인 옵션은 그냥 무시됩니다.
- 기대하는 형태로 배포검토는 포맷된 사본으로 하되, 배포는 시스템이 기대하는 형태로 하세요. 보기 좋은 인쇄는 사람을 위한 것이지 전송을 위한 것이 아닙니다.
텍스트뿐 아니라 트리를 검사하기
트리 뷰는 리뷰어가 실제로 던지는 질문에 답합니다. 어떤 키가 있는지, 각 값의 타입은 무엇인지, 구조가 얼마나 깊은지. 괄호를 세지 않고서요. 날것의 텍스트는 어느 하나도 빨리 답하지 못합니다.
자동 검사가 켜져 있으면 붙여 넣은 JSON은 즉시, 직접 입력한 내용은 잠시 멈춘 뒤 검사합니다. 서식 지정 및 검증 버튼도 사용할 수 있습니다. 구문 오류에는 위치와 복구 힌트를 표시하며 유효한 입력은 트리·서식·압축 보기로 확인할 수 있습니다.
요약에는 노드 수와 깊이를 표시합니다. 예약된 프로토타입 키는 거부하지만 앱의 보안을 인증하지는 않습니다.
트리는 리뷰 대화도 평평하게 합니다. “items의 세 번째 요소의 price가 null”이라는 코멘트는 누구나 몇 초 만에 검증할 수 있지만, 압축된 줄의 바이트 오프셋은 그렇지 않습니다.
JSON Tree Viewer 열기두 문서를 결정적으로 diff하기
키 순서가 바뀌는 순간, 눈으로 두 JSON을 비교하는 것은 실패합니다. 구조적 diff는 양쪽을 파싱해 실제로 바뀐 것—추가, 삭제, 수정된 값—을 순서나 공백과 무관하게 보고합니다.
Text & JSON Diff에는 텍스트와 JSON 모드가 있습니다. 텍스트에서는 스마트, 줄, 단어, 문자 단위를 고를 수 있습니다. JSON 모드는 양쪽을 파싱해 값을 비교하므로 키 순서나 공백만 바뀌면 동일하다고 보고합니다.
JSON이 아닌 텍스트에서는 공백 무시와 줄바꿈 정규화 옵션을 쓸 수 있고, 요약에 추가·삭제·변경 건수가 표시됩니다. 페이로드나 설정에는 JSON 모드를 쓰고, 어느 한쪽이 유효한 JSON이 아니면 텍스트 모드로 전환하세요.
결정성은 편의 이상의 의미가 있습니다. 두 리뷰어가 같은 비교를 실행하면 같은 답이 나와야 합니다. 그렇지 않으면 리뷰는 변경에 대한 결정이 아니라 도구에 대한 협상이 됩니다.
Text & JSON Diff 열기로컬 런타임의 한계 알기
이것들은 명시적 상한이 있는 로컬 런타임으로, 대량 데이터 처리가 아니라 리뷰 페이로드용 크기입니다. 상한을 알면 데스크톱 도구로 바꿔야 할 시점을 알 수 있습니다.
상한이 있는 이유는 파싱과 diff가 당신이 읽고 있는 바로 그 탭에서 실행되기 때문입니다. 정직한 상한이 멈춘 페이지보다 낫고, 작업 공간은 초과를 조용한 절단이 아니라 명시적 오류로 보고합니다.
- 뷰어 상한JSON Tree Viewer는 최대 256KiB 입력, 40단계 중첩, 10,000노드까지 받습니다. API 응답이나 설정 파일에는 충분하고도 남습니다.
- diff 상한텍스트 모드는 각 측 최대 256K자까지 받습니다. JSON 모드에는 각 측 256 KiB의 UTF-8 파싱 한도가 추가됩니다. 두 모드 모두 차이 기록은 최대 10,000건입니다.
- 브라우저 밖더 큰 내보내기—데이터베이스 덤프, 로그 아카이브, 생성된 픽스처—는 브라우저 탭이 아니라 데스크톱 편집기나 명령줄 도구의 영역입니다.
5분 검토 체크리스트
대부분의 페이로드 문제가 프로덕션에 닿기 전에 잡아내는 짧은 루틴입니다.
실제 페이로드뿐 아니라 생산자의 샘플 데이터에도 체크리스트를 돌려 보세요. 현실과 어긋나는 픽스처는 버그만큼 확실하게 리뷰를 무효화합니다.
- 파싱먼저 포맷하고 파싱하세요: 문서가 유효한지 확인하고 노드 수와 깊이가 기대와 맞는지 훑어봅니다.
- 검사트리를 검사하세요: 리프의 타입을 확인합니다. 숫자 식별자가 문자열로 도착하는 것은 전형적인 통합 버그입니다.
- diff마지막으로 알려진 정상 버전과 JSON 모드로 diff하고, 보고된 변경을 모두 읽은 뒤 승인하세요.
페이로드를 기기에 두기
검토 페이로드에는 고객 레코드, 토큰, 내부 URL이 들어 있는 경우가 많습니다. 로컬 뷰어는 그 자료를 탭 안에 둡니다. 텍스트는 당신의 기기에서 실행되는 코드가 파싱하며, 작업의 일부로 전송되는 일이 없습니다.
이 경계가 있기에 리뷰 중 실제 스테이징 페이로드로 이 도구들을 쓸 수 있습니다. 그렇다고 당신의 의무가 사라지는 것은 아닙니다. 내보낸 파일, 클립보드 내용, 트리의 스크린샷은 작업 공간을 떠난 뒤에도 신중히 다뤄야 할 것들입니다.
리뷰에서 페이로드 일부를 공유해야 한다면 문제를 보여 주는 최소 발췌만 붙여 넣고 식별자는 먼저 가리세요. 지원 채널이 요구하는 것과 같은 수칙입니다.
현재 실행 사양
사양 개정 버전: 2026-10-05.2
동일 페이지 전달은 최대 256 KiB의 UTF-8 텍스트를 10분 동안 유지합니다. 수신 도구의 파싱 및 표시 제한은 별도입니다.
JSON Tree Viewer와 Structured Data Converter는 동일 페이지의 대상 하나에 출력을 전달합니다. 트리는 JSON만, Converter와 Text & JSON Diff는 JSON, YAML, CSV를 받습니다. 대상을 열어도 변환은 자동 실행되지 않습니다.
텍스트는 페이지 메모리에만 있으며 URL, 영구 저장소, 분석에 포함되지 않습니다. 닫기, 원본 교체, 페이지 이동, 새로고침, 만료 시 폐기됩니다. 만료 당시 대상 내부에 초점이 있을 때만 원본 제목으로 돌려줍니다.
자주 묻는 질문
왜 리뷰 전에 JSON을 포맷해야 하나요?
두 JSON 설정을 확실하게 비교하려면 어떻게 하나요?
로컬 JSON 뷰어의 한도는 얼마인가요?
‘로컬 검사’가 신뢰할 만한 주장인 이유.
브라우저 런타임이 데이터를 기기에 두는 방식과, 리뷰에 쓰는 어떤 도구의 데이터 경로든 검증하는 방법을 알아보세요.