작동 원리 및 구조
재귀 스키마 워커가 Schema와 Data 트리를 함께 파싱하여 중첩 `properties`, `items`, `allOf`/`anyOf`/`oneOf`, 숫자 경계(`minimum`, `maximum`, `exclusiveMinimum`), 문자열 `minLength`/`pattern`/`format`, 엄격한 객체 규칙을 순회하고, 위반마다 정확한 JSON 포인터 경로와 실패 키워드를 출력합니다.
단계별 사용 방법
왼쪽 편집기에 JSON Schema 정의를 붙여넣습니다.
오른쪽 편집기에 검증할 JSON 페이로드를 붙여넣습니다.
즉시 표시되는 통과/실패 배너와 정확한 JSON 포인터 경로 및 실패 키워드(`type`, `enum`, `additionalProperties`, `minimum` 등)를 확인합니다.
필요하면 구조화된 JSON 오류 리포트를 복사합니다.
주요 기능 및 장점
- 불일치가 발생한 정확한 경로(`$.items[2].email`)와 실패 스키마 키워드를 한눈에 표시
- 객체 `required` 필수 키, `additionalProperties`, `enum`, `const`, 중첩 배열 검증 지원
- 내장 `format` 검증기(`email`, `uuid`, `date`, `date-time`, `ipv4`) 포함
- `allOf`, `anyOf`, `oneOf` 결합자와 문자열 `pattern` 정규식 지원
- 100% 오프라인 브라우저 실행: 비공개 API 명세와 고객 웹훅 샘플도 안전하게 검증
계산 방식, 공식 및 기술 표준
동적 코드 생성(`new Function`) 대신 파싱된 AST 객체 위에서 결정적 재귀 하강 방식으로 검증하므로 CSP 보안 정책을 준수하며 스키마 컴파일 오버헤드가 없습니다.
실제 활용 사례
- 클라이언트 배포 전 웹훅·REST API 요청 본문이 스키마 규격에 맞는지 검증
- 스테이징 환경의 Cloudflare Workers / JSON 설정 파일에 문서화되지 않은 키가 섞였을 때 디버깅
- Node 스크립트를 띄우지 않고 `null`, 정수 vs 실수, 빈 배열 등 엣지 케이스를 로컬에서 테스트
- 이슈 트래커나 버그 리포트에 구조화된 JSON 검증 오류 내역 공유
입출력 예시 및 엣지 케이스
Strict Object & Format Check
Plan: "enterprise" (enum: free/pro/team), seats: 0 (minimum: 1), extraField: true
$.plan (enum), $.seats (minimum), $.extraField (additionalProperties)
Reports all three distinct violations in one pass instead of stopping at the first error.
UUID & Email Format Validation
{ "id": "550e8400-e29b-41d4-a716-446655440000", "email": "ops@microdeck.tools" } Valid JSON against Schema (0 errors)
Verifies both RFC UUID v1-v8 format and basic email structure.
제한 사항 및 정확도 안내
- • 오프라인 개인정보 보호를 위해 외부 원격 `$ref` URL fetch는 의도적으로 비활성화되어 있으므로 인라인 스키마 또는 로컬 정의를 직접 붙여넣어 사용하세요.
- • JSON Schema Draft 2020-12의 고도화된 `$dynamicRef` / `unevaluatedProperties` 그래프 기능은 이 경량 검증기 범위 밖입니다.
브라우저 로컬 처리 및 개인정보 보호
일반 웹 변환기는 문서나 미디어 파일을 원격 서버에 업로드합니다. JSON 스키마 검증기 (JSON Schema Validator) 도구는 현재 브라우저 탭 내부에서만 실행됩니다:
입력 텍스트와 파일은 외부 서버로 전송되지 않고 기기 내에서 로컬로 계산됩니다.
도구에 붙여넣은 파일이나 데이터를 서버에 기록하거나 저장하지 않습니다.
작업 결과는 브라우저 탭 메모리에만 유지되며 탭을 닫거나 초기화하면 즉시 해제됩니다.
자주 묻는 질문 (FAQ)
첫 번째 오류에서 검증이 멈추나요, 아니면 모든 오류를 표시하나요?
전체 JSON 문서를 끝까지 순회해 모든 실패 경로를 수집·표시하므로 한 번에 여러 버그를 수정할 수 있습니다.
`integer`와 `number`는 다르게 검사되나요?
네. `type: "integer"`는 `Number.isInteger(val)`을 만족해야 하므로 `1.5`를 거부하지만, `type: "number"`는 실수(부동소수점)를 허용합니다.
원격 `$ref` HTTP 요청을 불러오지 않는 이유는 무엇인가요?
Microdeck 도구는 기업 내부 스키마와 페이로드를 보호하기 위해 외부 네트워크 요청을 절대 발생시키지 않습니다.
검증 오류 목록을 JSON으로 복사할 수 있나요?
네. 오류가 발생하면 Copy Error Report 버튼을 눌러 `{ path, keyword, message }` 객체 배열을 바로 복사할 수 있습니다.