무료 JSONPath 테스터 — 온라인으로 쿼리 평가

JSONPath 테스터란?

// The expression you build in this tester maps straight onto the
// RFC 9535 reference library used under the hood.
import { query, paths } from 'jsonpath-rfc9535';

const document = {
  store: {
    book: [
      { title: 'Sayings of the Century', author: 'Nigel Rees', price: 8.95 },
      { title: 'Sword of Honour', author: 'Evelyn Waugh', price: 12.99 },
      { title: 'Moby Dick', author: 'Herman Melville', price: 8.99 },
      { title: 'The Lord of the Rings', author: 'J. R. R. Tolkien', price: 22.99 }
    ]
  }
};

// Values: query(document, path) returns the matched values directly.
const titles = query(document, '$.store.book[*].title');
// → ['Sayings of the Century', 'Sword of Honour', 'Moby Dick', 'The Lord of the Rings']

// Filter: books cheaper than 10.
const cheap = query(document, '$.store.book[?(@.price < 10)].title');
// → ['Sayings of the Century', 'Moby Dick']

// Normalized paths: paths(document, path) returns where each match lives.
const authorPaths = paths(document, '$..author');
// → ["$['store']['book'][0]['author']", "$['store']['book'][1]['author']", ...]

// RFC 9535 functions like length() are used INSIDE filters, not as a segment.
const longTitles = query(document, '$.store.book[?length(@.title) > 15]');
// → the two books whose title is longer than 15 characters

주요 기능

작업 예제

$.store.book[*].title

["Sayings of the Century", "Sword of Honour", "Moby Dick", "The Lord of the Rings"]

$.store.book[?(@.price < 10)].title

["Sayings of the Century", "Moby Dick"]

$..author

["Nigel Rees", "Evelyn Waugh", "Herman Melville", "J. R. R. Tolkien"]

$.store.book[0:2].title

["Sayings of the Century", "Sword of Honour"]

$.store.book[?length(@.title) > 15]

[{"title": "Sayings of the Century", "author": "Nigel Rees", "price": 8.95}, {"title": "The Lord of the Rings", "author": "J. R. R. Tolkien", "price": 22.99}]

$.store.book[0]['title','author']

["Sayings of the Century", "Nigel Rees"]

JSONPath 테스터 사용법

1. 1

   JSON을 붙여넣거나 업로드하기

   JSON을 입력 상자에 끌어다 놓거나 붙여넣거나, 업로드를 클릭해 디스크의 .json / .txt 파일을 불러오세요. JSON 포맷이 문서를 다시 들여씁니다. 유효하지 않은 JSON은 쿼리 전에 파서 메시지와 함께 인라인으로 표시됩니다.

2. 2

   엔진 선택하기

   RFC 9535(2024 IETF 표준, eval 미사용)가 기본값입니다. jsonpath.com 같은 오래된 도구에서 복사한 식을 실행할 때는 클래식(Goessner)으로 전환해 거기서 본 결과와 일치하게 하세요.

3. 3

   JSONPath 식 입력하기

   선행 $는 미리 표시됩니다. .store.book[*].title 같은 자식 경로, [0] 같은 인덱스, ..author 같은 재귀 하강, [?(@.price < 10)] 같은 필터로 시작하세요. 입력하는 대로 결과가 실시간으로 갱신됩니다.

4. 4

   결과 보기 전환하기

   값은 일치한 값의 JSON 배열을 보여줍니다. 경로는 각 일치의 정규화 경로를 $['store']['book'][0]['title']처럼 보여줍니다. 둘 다는 둘을 나란히 보여주어 모든 값을 문서 내 정확한 위치에 대응시킬 수 있습니다.

5. 5

   결과 복사 또는 영구 링크 공유하기

   결과 복사는 출력을 클립보드에 담습니다. 링크 복사는 JSON, 식, 엔진, 보기를 URL 해시로 인코딩하므로(업로드 없음) 동료가 자신의 기기에서 정확히 같은 쿼리를 로컬로 재현할 수 있습니다.

흔한 JSONPath 실수

store.book[*].title  →  invalid (no root)

$.store.book[*].title  →  selects every title

$.store.book[0:2]  →  first TWO books, not three

$.store.book[0:3]  →  first three books (indices 0,1,2)

Classic filter run under RFC 9535  →  parse error or unexpected nodes

Switch engine to Classic (Goessner)  →  reproduces the original result

$.store.book.length()  →  parse error (not a valid RFC 9535 segment)

$.store.book[?length(@.title) > 15]  →  books with a title over 15 chars

$.store.book[?($.price < 10)]  →  wrong scope

$.store.book[?(@.price < 10)]  →  books under 10

$[store][book]  →  invalid bracket selectors

$['store']['book']  →  same as $.store.book

$..price  →  every price anywhere in the tree

$.store.book[*].price  →  only book prices

이 도구를 누가 사용하나요

API 응답에서 필드 추출하기

순회 코드를 작성하지 않고 JSON 페이로드에서 요청 ID, 중첩 리소스 속성, 또는 이름 목록을 뽑아내세요. 여기서 샘플 응답에 대해 경로를 만들고, 값 보기에서 원하는 노드를 정확히 반환하는지 확인한 뒤, 검증된 식을 애플리케이션이나 테스트에 붙여넣으세요.

통합 테스트용 단언 작성하기

많은 테스트 프레임워크와 계약 테스트 도구(REST Assured, Karate, Postman)가 응답 본문을 단언하는 데 JSONPath를 씁니다. 여기서 단언 경로를 초안하고, 실제 응답에 대해 올바른 노드를 선택하는지 검증한 뒤 테스트에 복사하세요 — 스위트가 실패하기 전에 잘못된 경로를 잡습니다.

파이프라인에서 데이터 변환 설정하기

Kubernetes, AWS Step Functions, Azure Logic Apps, 그리고 많은 ETL 도구가 이벤트 페이로드의 필드를 지정하는 데 JSONPath를 받아들입니다. 여기서 대표 이벤트에 대해 정확한 경로를 프로토타이핑하고, 해석되는지 확인한 뒤, 의도한 곳을 가리킨다는 확신을 갖고 파이프라인 설정에 넣으세요.

jsonpath.com 결과를 비공개로 재현하기

서버 기반 평가기의 식이 있지만 제3자 사이트에 데이터를 붙여넣을 수 없나요? 클래식(Goessner) 모드로 전환하고 JSON을 불러와 같은 결과를 로컬에서 재현하세요 — 페이로드가 브라우저를 결코 떠나지 않으므로 독점 데이터가 기기에 머뭅니다.

레거시 식을 RFC 9535로 마이그레이션하기

RFC 9535 준수를 표방하는 시스템으로 이전하나요? 레거시 식을 클래식 모드에서 실행한 뒤 RFC 9535 엔진으로 전환해 여전히 파싱되고 같은 노드와 일치하는지 보세요. 듀얼 엔진 비교는 프로덕션에서 부딪힐 필터, 합집합, 함수 차이를 짚어냅니다.

경로가 잘못된 노드를 반환하는 이유 디버깅하기

너무 많이 또는 너무 적게 선택하는 경로는 값만 보고 추론하기 어렵습니다. 경로 보기로 전환해 모든 일치의 정규화 위치 — 정확한 배열 인덱스, 정확한 멤버 사슬 — 를 보면 오프바이원 슬라이스나 빗나간 재귀 하강이 즉시 명확해집니다.

JSONPath 가르치거나 검토하기

샘플 데이터에 대해 동작하는 식을 열어 선택자 하나하나 짚어가며, 값과 경로를 오가 학습자가 무엇이 선택되고 어디에 있는지 모두 보게 하세요. 치트 시트와 작업 예제가 코드 리뷰나 온보딩을 위한 구조화된 참조를 제공합니다.

엔진 & 알고리즘 참고

RFC 9535 엔진 (jsonpath-rfc9535, 의존성 없음)

기본 엔진은 IETF RFC 9535 문법을 직접 구현합니다. 식을 토큰화·파싱하여 추상 구문 트리로 만들고 문서에 대해 해석합니다. 경로 어디에도 eval이나 Function 생성자가 없으므로 eval 주입 부류의 버그에 면역이며 엄격한 콘텐츠 보안 정책 아래에서 실행됩니다.

클래식 엔진 (jsonpath-plus, eval 비활성화)

클래식(Goessner) 엔진은 패치 릴리스(>= 10.4.0)에 고정되고 eval 옵션이 명시적으로 false로 설정되어 구성된 jsonpath-plus입니다. 이는 Goessner 방언 호환성을 유지하면서 라이브러리의 기본 eval 기반 필터 경로에 영향을 준 CVE-2024-21534와 CVE-2025-1302로 추적되는 원격 코드 실행 벡터를 차단합니다.

정규화 경로 생성

모든 일치는 RFC 9535 정규화 경로와 함께 보고됩니다 — 작은따옴표 대괄호 표기($['store']['book'][0]['title'])를 쓰고 배열 인덱스는 정수 그대로 두는 정규 형식입니다. 정규화 경로는 노드별로 안정적이고 고유하므로 동등한 식이 동일한 경로를 산출하며, 경로 보기와 둘 다 보기가 모호하지 않은 결과 식별을 위해 이에 의존합니다.

지연 로드 엔진 청크

두 엔진 모두 처음 선택될 때만 별도의 JavaScript 청크로 로드되므로 초기 페이지가 가볍게 유지되고 쓰지 않는 엔진은 결코 다운로드되지 않습니다. 엔진 전환은 페이지 새로고침 없이 현재 식을 현재 문서에 대해 즉시 다시 평가합니다.

로컬 파일 읽기 및 JSON 포맷팅

업로드 버튼은 브라우저 FileReader API로 .json 또는 .txt 파일을 전적으로 클라이언트 측에서 입력으로 읽습니다 — 파일은 결코 전송되지 않습니다. JSON 포맷은 입력을 두 칸 들여쓰기로 파싱·재직렬화하며, 파싱 오류를 인라인으로 드러내 잘못된 형식의 JSON이 평가 전에 잡힙니다.

URL 해시를 통한 영구 링크 (전송되지 않음)

공유 상태는 location.hash 프래그먼트에 인코딩되어 JSON, 식, 활성 엔진, 결과 보기를 담습니다. 브라우저는 프래그먼트를 HTTP 요청에 결코 포함하지 않으므로, 영구 링크가 열릴 때 go-tools.org 서버는 데이터를 0건 수신합니다. 복원은 전적으로 수신자의 기기에서 일어납니다.

JSONPath 모범 사례

대상에 맞는 엔진 선택하기

다운스트림 시스템이 RFC 9535 준수를 표방하면 RFC 9535 엔진으로 작성·검증하세요. 오래된 도구나 라이브러리의 식을 재현하거나 유지보수한다면 클래식(Goessner)을 쓰세요. 잘못된 방언으로 검증하는 것이 테스터에서 동작한 경로가 프로덕션에서 실패하는 가장 흔한 이유입니다.

값뿐 아니라 경로 보기로 검증하기

값 보기는 무엇이 일치했는지 알려주고, 경로 보기는 어디인지 알려줍니다. 쿼리가 그럴듯한 값을 반환해도 잘못된 위치에서 선택하고 있을 수 있습니다 — 빗나간 재귀 하강이나 지나치게 넓은 와일드카드 말이죠. 정규화 경로를 확인해 식이 의도한 노드를 정확히 맞히는지 확인하세요.

슬라이스의 배타적 끝에 유의하기

[0:2]는 인덱스 0과 1을 선택하며 0부터 2까지가 아닙니다 — 끝 경계는 Python·JavaScript와 마찬가지로 배타적입니다. 오프바이원 슬라이스 오류는 가장 빈번한 JSONPath 버그입니다. 경로 보기로 선택된 모든 요소의 정확한 인덱스를 읽고 출시 전에 경계를 확인하세요.

가능하면 재귀 하강보다 명시적 경로 선호하기

$..price는 편하지만 의도하지 않은 것을 포함해 문서 어디에 있는 price든 일치시킵니다. 구조를 알 때는 경로를 명시하세요($.store.book[*].price) — 데이터가 커져도 쿼리가 정밀하고 예측 가능하게 유지됩니다. ..은 진정으로 불규칙하거나 알 수 없는 형태에만 남겨두세요.

필터에서 공백과 따옴표를 일관되게 유지하기

RFC 9535는 필터 식에 문법을 정확히 따르는 반면 클래식 방언은 더 느슨합니다. 필터를 깔끔하게 쓰세요 — 문자열 리터럴을 작은따옴표('fiction')로 감싸고, 연산자에 공백을 두며, 관대한 파싱에 의존하지 마세요 — 그러면 어떤 엔진이나 라이브러리가 결국 실행하든 같은 식이 같은 방식으로 평가됩니다.

자주 묻는 질문