01
교체할 내용을 먼저 확인
파일 가져오기, 예제 불러오기, 지우기는 교체 미리보기를 먼저 표시합니다. 적용 후 실행 취소하면 이전 입력, 결과, 설정을 복원할 수 있습니다.
JSON 도구
JSON 평탄화경로에 타입까지 보존
평탄화 또는 복원을 선택한 뒤 변환을 실행하세요. 입력이나 설정을 바꾸면 다시 실행해야 합니다.
JSON 평탄화
JSON 입력
결과
복사와 다운로드는 보이는 미리보기 밖의 전체 결과를 포함합니다.
JSON은 브라우저 메모리에만 있으며 업로드하거나 저장하지 않습니다.
버전이 있는 전용 형식: k:는 객체 키, i:는 배열 인덱스입니다. 백슬래시로 구분자와 백슬래시를 이스케이프하며 빈 경로는 루트입니다.
결과가 오래되었습니다. 복사와 다운로드가 비활성화됩니다.
설정 파일이나 API 응답이 여러 단계로 중첩되어 있다면 JSON 평탄화로 개별 값의 위치를 한눈에 확인할 수 있습니다. 객체를 차례로 펼치지 않고도 깊이 있는 설정 항목을 찾아 비교하기 좋습니다.
중첩 객체 평탄화 결과는 버전, 구분자, 배열 전략을 포함하는 전용 JSON 형식입니다. 복원은 이 정보를 읽으며 일반적인 점 표기법 키를 임의로 해석하거나 숫자 키를 배열 인덱스로 추측하지 않습니다.
JSON 평탄화를 사용하는 이유
숫자 키와 배열 인덱스 구분
JSON 평탄화는 객체 키에 k:, 배열 인덱스에 i:를 붙입니다. 따라서 "0"이라는 객체 키는 배열의 첫 요소와 다릅니다. 키 안의 구분자도 이스케이프해 실제 중첩 단계와 구별합니다.
배열을 펼치거나 통째로 유지
JSON 평탄화에서 배열 내부 항목을 각각 확인하려면 인덱스 확장을, 목록 전체를 함께 다루려면 배열 유지를 선택하세요. 빈 객체와 빈 배열도 남아 복원할 때 빈 설정 영역이 사라지지 않습니다.
한 번 복원해서 확인하기
02
실행 전에 배열 전략 선택
인덱스 확장은 배열 요소를 나누고 배열 유지는 전체 배열을 남깁니다. 구분자는 콜론과 백슬래시를 제외한 ASCII 문장 부호 한 글자입니다. 설정 변경은 자동 실행되지 않으며 이전 결과는 오래된 상태가 됩니다.
03
전체 결과로 복원
결과 사용은 교체를 미리 보여 주고 적용할 때 방향도 반대로 바꿉니다. 복원하려면 메타데이터와 모든 항목을 유지하세요. 화면은 5,000자씩 더 표시하지만 복사와 다운로드는 전체 유효 결과를 포함합니다.
구조를 구별하는 경로
키와 인덱스의 명시적 타입
객체 경로 요소는 k:, 배열 요소는 i:로 시작합니다. 빈 경로는 루트이므로 단독 스칼라, null, 빈 컨테이너도 표현합니다.
구분자를 되돌릴 수 있게 처리
키 안의 구분자와 백슬래시를 백슬래시로 이스케이프합니다. 복원은 이 형식에서 정한 정규 표기를 요구하므로 모호한 경로를 그대로 받아들이지 않습니다.
숫자 원문 표기 보존
큰 정수, -0, 소수, 1e999 같은 지수 표기를 JSON 숫자 텍스트로 보존합니다. 계산하지 않으며 JavaScript 숫자로 변환해 반올림하지 않습니다.
문서 전체의 충돌 검사
중복 키, 경로 충돌, 희소 배열, 혼합 컨테이너 타입은 거부합니다. 실패한 변환의 일부 결과를 완성된 출력처럼 내보내지 않습니다.
형식과 처리 범위
- 전용 결과만 복원
- heyutils-json-flat-v1 형식의 separator, arrays, entries를 포함한 결과를 읽습니다. 일반 점 경로 객체, JSONPath 표현식, 다른 도구의 평탄화 형식은 직접 호환되지 않습니다.
- 엄격한 JSON 입력
- 주석, 후행 쉼표, 중복 객체 키는 거부합니다. 일반 부동소수점 범위를 넘는 유효 숫자도 원문을 보존하지만 숫자 토큰 하나는 1,000자 이하여야 합니다.
- 문자 수와 구조 제한
- 입력과 출력은 각각 500,000자, 가져오는 파일은 500,000바이트까지입니다. 최대 깊이는 100, 노드 예산은 50,000입니다. 한도를 넘으면 결과를 자르지 않고 오류를 표시합니다.
- 연속된 배열 인덱스
- 확장하는 인덱스는 10,000 미만이며 빠진 항목이 없어야 합니다. 배열 유지는 노드 예산 안에서 더 긴 배열도 허용하지만 복원 시 i: 경로를 거부합니다. 접두 경로 충돌, 타입 혼합, 비정규 경로도 거부합니다.
- 브라우저 메모리에서 처리
- 원격 URL을 가져오거나 변환 기록을 저장하지 않습니다. CSV 내보내기도 제공하지 않습니다. 새로고침하면 현재 작업 내용은 사라집니다.
JSON 평탄화 자주 묻는 질문
중첩된 객체는 어떻게 처리하나요?
JSON 평탄화는 각 객체 키를 k: 요소로 연결해 값에 이르는 경로를 만듭니다. 비어 있지 않은 객체는 계속 순회하며 빈 객체는 그 위치에 값으로 남깁니다.
배열이 있는 데이터를 어떻게 복원하나요?
이 도구가 만든 전체 결과를 입력하고 복원을 선택하세요. 저장된 배열 전략과 i: 인덱스를 사용하므로 객체의 숫자 키를 배열로 추측하지 않습니다.
중첩된 배열을 어떻게 평탄화하나요?
인덱스 확장 전략을 선택하면 배열 속 배열과 배열 속 객체까지 각각의 경로를 생성합니다. 배열 내부를 개별 항목으로 나누고 싶지 않으면 배열 유지를 선택하세요.
중첩 배열 평탄화를 어떻게 되돌리나요?
결과 사용을 선택해 교체 내용을 확인하고 적용하면 방향이 복원으로 전환됩니다. 다른 도구가 만든 점 경로 출력은 먼저 이 전용 형식으로 변환해야 합니다.
여러 단계로 중첩된 데이터도 처리할 수 있나요?
가능합니다. 최대 깊이 100과 노드 및 문자 수 한도 안에서 중첩된 객체와 배열을 순회합니다. 한도 초과 시 부분 결과를 내보내지 않고 오류를 알립니다.
복원이 되지 않는 경로를 발견했나요?
먼저 한 번 복원해 보세요
예제로 JSON 평탄화를 실행하고 경로의 타입을 살펴보세요. 결과를 다시 복원해 구조가 맞는지 확인한 뒤 실제 설정 파일을 변환할 수 있습니다.