alphx.dev

JSON 포맷터

JSON 포맷터 올바른 사용법

공공 데이터 API 결과값, 로그 데이터, 혹은 한 줄로 길게 늘어진 미니파이된 JSON 텍스트를 가독성 좋게 변환해 주는 도구입니다. 문법 오류 검증과 정렬을 한 번에 처리할 수 있습니다.

1. 원본 데이터 입력분석하거나 정렬하고 싶은 JSON 문자열을 텍스트 영역에 붙여넣습니다. 줄바꿈이 없거나 공백이 엉망이어도 상관없습니다.
2. 문법 검증 및 변환'포맷팅하기' 버튼을 누르면 자바스크립트 엔진이 표준 규격을 검사한 뒤, 깨끗하게 들여쓰기된 4칸(4-spaces) 구조로 재정렬합니다.
3. 결과 복사 및 활용변환이 완료되면 '복사하기' 버튼을 눌러 클립보드에 담은 뒤, 코드 에디터나 설정 파일 등에 곧바로 붙여넣어 사용하세요.

자주 묻는 질문 (FAQ)

Q. 분명 올바른 데이터 같은데 계속 "JSON 형식이 올바르지 않습니다"라고 뜹니다.

자바스크립트 객체 리터럴(Object) 문법과 표준 JSON(JavaScript Object Notation) 규격의 차이 때문에 발생하는 현상입니다. JSON 표준은 매우 엄격합니다. 다음과 같은 흔한 실수들을 점검해 보세요.

  • 따옴표 종류 오류: 키(Key)와 값(Value) 문자열은 반드시 쌍따옴표(")만 사용해야 합니다. 홑따옴표(')는 문법 오류를 유발합니다.
  • 키(Key)의 따옴표 생략: 자바스크립트 코드와 달리 { name: "JSON" } 처럼 키에 따옴표가 없으면 유효하지 않습니다. { "name": "JSON" } 형태여야 합니다.
  • 마지막 쉼표(Trailing Comma): 배열의 마지막 요소나 객체의 마지막 속성 뒤에 쉼표(,)가 남아있으면 파싱에 실패합니다.

Q. 사내 기밀 데이터나 개인정보가 담긴 API 로그를 검사해도 안전한가요?

100% 안전합니다. 이 도구는 서버 환경으로 데이터를 전송하는 백엔드 API 연동이 전혀 없습니다. 브라우저 내부에서 JSON.parse() 함수를 사용해 전적으로 웹 클라이언트 환경에서만 독립적으로 동작합니다. 네트워크 통신이 발생하지 않으므로 외부 유출이나 로그 저장 우려 없이 중요 보안 정보, 패스워드 토큰, 커스터머 데이터를 마음 편히 포맷팅하셔도 됩니다.

Q. JSON 안에 주석(// 또는 /* */)을 넣었는데 왜 에러가 나나요?

표준 JSON 규격 사양서에 따르면, JSON은 데이터 포맷이므로 주석을 공식적으로 지원하지 않습니다.따라서 // 설명글 같은 주석 코드가 포함되어 있으면 브라우저의 파서 엔진이 이를 유효하지 않은 문자열로 판단해 오류를 내뱉게 됩니다. 주석을 모두 지우고 순수한 데이터 노드 조합만 입력창에 넣어주셔야 정상적으로 정렬 기능이 작동합니다.

Q. 포맷팅 결과물의 들여쓰기 깊이(Tab/Space)를 커스텀할 수 있나요?

현재 제공되는 코드는 가독성이 가장 뛰어난 **4칸 공백(Space 4)**을 기본값으로 고정하여 빌드되어 있습니다. 만약 2칸 들여쓰기(Space 2) 스타일로 컴팩트하게 압축하고 싶으시다면, 코드 내부의 JSON.stringify(parsed, null, 4) 부분에서 마지막 인자인 4를 2로 수정하여 유연하게 커스터마이징할 수 있습니다.

Q. 거대한 용량의 대용량 JSON 파일도 처리가 가능한가요?

수 십 메가바이트(MB) 수준의 대형 텍스트 파일 데이터도 처리는 가능합니다만, 브라우저 단일 스레드 메모리 한계에 따라 텍스트가 너무 길면 화면 렌더링 과정에서 일시적으로 버벅임(Freeze) 현상이 발생할 수 있습니다. 수만 라인이 넘어가는 극단적인 대용량 덤프 데이터의 경우, 웹 도구보다는 VS Code 등의 전문 로컬 텍스트 에디터 플러그인을 활용하시는 것을 권장합니다.