작동 원리 및 구조
평가기가 루트 `$`부터 시작해 자식 키, 와일드카드(`*`), 음수 배열 인덱스(`[-1]`), 슬라이스 범위(`[start:end]`), 재귀 하위 트리 탐색(`..`), 그리고 안전하지 않은 `eval()` 없이 작동하는 AST 비교 조건자(`==`, `!=`, `<`, `<=`, `>`, `>=`, 불리언)를 파싱해 순회합니다.
단계별 사용 방법
왼쪽 JSON 입력 창에 조회할 JSON 객체 또는 배열을 붙여넣습니다.
`$.store.books[*].title` 같은 JSONPath 표현식을 입력하거나 빠른 프리셋을 클릭합니다.
포맷된 JSON 형태로 추출된 결과 값과 각 결과가 위치한 정확한 노드 경로(`$['store']...`)를 확인합니다.
테스트 코드, API 모킹, 자동화 스크립트에 바로 쓸 수 있도록 일치 결과 JSON 배열을 복사합니다.
주요 기능 및 장점
- 점(`.`) 및 대괄호(`[]`) 표기법, 배열 와일드카드 `[*]`, 음수 인덱스 `[-1]`, 슬라이스 `[0:3]` 완벽 지원
- 임의의 깊은 중첩 구조도 한 번에 찾는 재귀 탐색 `$..key` 지원
- 안전하지 않은 `eval()` 없이 `[?(@.price < 20)]`, `[?(@.inStock)]` 및 문자열 동등성 필터 평가
- 추출된 모든 값 옆에 실제로 매칭된 정확한 노드 경로(Path)를 함께 표시
- 민감한 API 응답이나 웹훅 페이로드를 안심하고 조회할 수 있는 100% 브라우저 로컬 동작
계산 방식, 공식 및 기술 표준
모든 표현식은 `eval()`이나 `new Function()`을 전혀 쓰지 않는 재귀 경로 평가기를 통해 실행되므로 코드 인젝션 위험을 원천 차단하고 엄격한 CSP 보안을 준수하며 결정론적인 순회 순서를 보장합니다.
실제 활용 사례
- Postman, Playwright, AWS Step Functions, Kubernetes/AWS CLI 워크플로우용 응답 추출식 작성
- 웹훅 JSON 페이로드 깊숙이 숨어 있는 특정 ID나 배열 데이터를 빠르게 디버깅
- 설정 파일 배포 전 음수 배열 인덱스(`[-1]`)와 조건 필터 표현식 동작 사전 검증
- 방대한 OpenAPI / GraphQL JSON 스냅샷 데이터를 로컬에서 간편히 탐색
입출력 예시 및 엣지 케이스
Filter Books Under $20
$.store.books[?(@.price < 20)].title
["Browser Cryptography", "Zero-Backend Architecture", "WebAssembly Field Guide"]
Filters objects first, then extracts only the requested property.
Recursive Price Extraction
$..price
[14.5, 24, 8.99, 19.5]
Collects matching keys at any depth.
제한 사항 및 정확도 안내
- • 필터 조건자는 단일 이항/참거짓 조건(`@.prop op literal`)을 평가하며, `[?(...)]` 내부의 복합 `&&`/`||` 연결이나 정규표현식 스크립트 호출은 아직 지원하지 않습니다.
- • 유효하지 않은 JSON을 입력하면 네이티브 `JSON.parse` 기준의 정확한 구문 오류 위치를 알려줍니다.
브라우저 로컬 처리 및 개인정보 보호
일반 웹 변환기는 문서나 미디어 파일을 원격 서버에 업로드합니다. JSONPath 표현식 & 필터 쿼리 테스터 도구는 현재 브라우저 탭 내부에서만 실행됩니다:
입력 텍스트와 파일은 외부 서버로 전송되지 않고 기기 내에서 로컬로 계산됩니다.
도구에 붙여넣은 파일이나 데이터를 서버에 기록하거나 저장하지 않습니다.
작업 결과는 브라우저 탭 메모리에만 유지되며 탭을 닫거나 초기화하면 즉시 해제됩니다.
자주 묻는 질문 (FAQ)
이 JSONPath 엔진은 내부적으로 `eval()`을 사용하나요?
아니요. 필터 조건은 임의의 JavaScript로 실행하지 않고 명시적인 토큰 단위로 파싱하므로 보안과 동작 예측 가능성이 모두 뛰어납니다.
음수 배열 인덱스나 슬라이스는 어떻게 동작하나요?
`$[-1]`은 마지막 요소를, `[-2]`는 뒤에서 두 번째 요소를 선택하며 `[0:2]` 같은 슬라이스는 시작 포함/끝 미포함(half-open) 범위 규칙을 따릅니다.
추출된 값이 원본 JSON 트리의 어느 위치에서 나왔는지 알 수 있나요?
네. JSON 출력 패널 아래에서 일치하는 모든 결과의 정규화된 대괄호 경로를 확인할 수 있습니다.
JSON 데이터에 개인정보(PII)나 인증 토큰이 들어있어도 괜찮나요?
파싱과 쿼리 모두 브라우저 RAM 내부에서만 실행되므로 단 1바이트의 페이로드도 컴퓨터 밖으로 나가지 않습니다.
관련 마이크로 도구 살펴보기
JSON 포맷터 · 유효성 검사기 & Diff 비교 도구
오류가 있는 JSON을 안전하게 자동 복구하고, 트리 뷰 탐색 및 구조 비교(Diff)를 실행하세요
JSON 스키마 검증기 (JSON Schema Validator)
서버 전송 없이 브라우저에서 JSON Schema 규칙(`required`, `type`, `enum`, `format`, `additionalProperties`)을 즉시 검증
NDJSON / JSON Lines 로그 탐색기 & 필터
스트리밍 `.ndjson` / `.jsonl` 로그를 검색 가능한 표로 파싱하고 오류 줄을 식별해 CSV·JSON·NDJSON으로 내보내기