JSONPath 테스터

JSON 데이터에 JSONPath 표현식을 실시간으로 테스트. 구문 강조로 매칭 결과 확인. 필터, 와일드카드, 재귀 하강 지원. 무료, 브라우저 기반.

  • 브라우저에서 처리
  • 도구 입력을 ZeroTool 서버에 업로드하지 않습니다
  • 무료 · 회원가입 불필요
표현식은 $로 시작합니다. 어느 입력을 바꿔도 조회합니다. RFC 9535의 와일드카드, 음수 인덱스, 슬라이스, 필터를 지원합니다. 구문 오류나 지원하지 않는 구문은 문자 위치를 표시하며 빈 표현식은 결과를 비웁니다.
예시
「예시」를 펼쳐 쿼리를 선택하면 표현식만 바꾸고 현재 JSON을 조회합니다. 서점 데이터는 다시 로드하지 않습니다. 「예시」를 접어도 표현식은 유지됩니다.
미리 로드된 서점 JSON을 편집하거나 자신의 JSON 값을 붙여 넣으세요. 입력할 때마다 조회하며 숫자는 JavaScript 정밀도로 처리합니다. 값이 바뀌는 숫자(2^53을 넘는 정수 등)는 상태 줄에 표시합니다. 도구 안에서 Ctrl+L(Mac은 ⌘+L)을 누르면 두 입력과 결과를 비웁니다.

JSON과 JSONPath 표현식을 입력하면 일치하는 값이 표시됩니다.

결과 일치하는 값을 표시하며 정규화 경로는 표시하지 않습니다. 하나면 그 값, 여러 개면 JSON 배열로 표시합니다. 매칭 없음과 입력 오류는 서로 다른 메시지입니다. 긴 결과는 이 영역 안에서 스크롤됩니다. 「복사」는 표시된 JSON 전체를 복사합니다. 단일 문자열의 따옴표와 두 칸 들여쓰기도 포함합니다. 오류나 매칭 없음일 때는 복사할 수 없습니다. 실패하면 다시 눌러 재시도하세요.
자세한 가이드 읽기 JSONPath 테스터 온라인: 코드 없이 JSON 데이터 쿼리하기
예시·자세한 설명·자주 묻는 질문 실제 출력이 있는 예시, 다른 도구와의 차이, 자주 묻는 질문.

JSONPath 구문 참조 (RFC 9535)

  • $ — 문서 루트
  • .key, ['key'], ["key"] — 객체 멤버
  • [n], [-1] — 배열 요소. 음수 인덱스는 끝에서부터 셈
  • [start:end:step] — 슬라이스. 예: [0:2], [1:], [::-1]
  • [0,2], ['title','price'] — 대괄호 하나에 여러 선택자. 결과는 선택자 순서
  • [*], .* — 배열의 모든 요소 또는 객체의 모든 멤버 값
  • ..key, ..[0], ..* — 깊이에 관계없는 자손
  • [?@.price < 10] — 필터. [?(@.price < 10)]으로도 씀
  • [?@.isbn], [?!@.isbn] — 멤버가 있음 / 없음
  • [?@.a.b == 'x' && @.c > $.min] — 필터 안의 중첩 경로, && || !, $로 시작하는 절대 경로
  • length(), count(), match(), search(), value() — RFC 9535가 정의한 5개 함수

예시: 똑같아 보이는 한글 이름

HFS+(Mac OS 확장) 볼륨은 파일 이름을 분해형 유니코드(NFD에 가까운 형태)로 저장합니다(Apple Technical Q&A QA1173). 이렇게 저장된 이름을 그대로 JSON으로 내보내면 '보'가 초성 ᄇ(U+1107)과 중성 ᅩ(U+1169) 두 글자로 들어갑니다. 아래 예시는 그 상태를 이스케이프로 적은 파일 목록입니다. 첫 번째 이름도 화면에서는 '보고서.pdf'로 보입니다.

{"files": [
  {"name": "\u1107\u1169\u1100\u1169\u1109\u1165.pdf", "size": 120400},
  {"name": "보고서.pdf", "size": 98000}
]}

키보드로 입력한 $.files[?@.name == '보고서.pdf'].size는 완성형 이름만 찾아 [98000]을 돌려줍니다. 필터의 ==는 두 문자열을 그대로 비교하고 정규화하지 않기 때문입니다. 이름 선택자(['name'])로 멤버를 고를 때도 RFC 9535 §2.3.1.2에 따라 정규화하지 않습니다.

두 이름을 구별하려면 길이를 보면 됩니다. length()는 코드 포인트 수를 세므로 완성형 '보고서.pdf'는 7, 분해형은 10이고, $.files[?length(@.name) == 10].size는 [120400]을 돌려줍니다. 두 형태를 함께 찾으려면 JSON을 붙여 넣기 전에 NFC로 정규화해 두세요(JavaScript의 normalize('NFC') 등).

숫자처럼 보이는 키의 순서

$.순위.* 같은 와일드카드 조회는 JavaScript가 객체 멤버를 보관하는 순서대로 값을 돌려줍니다. '1', '10'처럼 배열 인덱스로 읽히는 이름이 먼저 숫자 오름차순으로 오고, 나머지 이름은 JSON에 적힌 순서를 따릅니다.

{"순위": {"10": "로또", "2": "환율", "1": "날씨"}}

JSON에는 "10", "2", "1" 순서로 적었지만 결과는 ["날씨","환율","로또"]입니다. 결과 창에 표시되는 객체도 같은 순서로 다시 정렬됩니다. RFC 9535 §2.3.2.2는 객체 멤버의 순서를 정하지 않으므로 다른 구현에서는 달라질 수 있습니다. 순서가 중요하면 배열로 바꿔 두세요.

제한 사항

  • 구문 오류와 RFC 9535에 없는 구문은 "구문 오류 또는 지원하지 않는 구문"과 문자 위치를 표시합니다. RFC 9535에 없는 구문의 예: 스크립트 표현식 [(...)], =~, in / nin, 다른 라이브러리의 ~(멤버 이름 가져오기) 같은 확장.
  • $.store.book.length는 length라는 이름의 멤버를 선택합니다. 배열에는 그런 멤버가 없으므로 결과가 비어 있습니다. 길이로 거르려면 필터 안에서 length()를 쓰세요(예: $[?length(@.book) > 3]).
  • 결과에는 매칭된 값만 나오고 정규화 경로($['store']['book'][0] 등)는 표시하지 않습니다.
  • 한 객체에 같은 이름이 두 번 있으면 JSON.parse가 뒤의 값만 남깁니다.
  • match()와 search()는 .을 [^\n\r]로 바꾼 뒤 u 플래그가 붙은 JavaScript 정규식으로 실행합니다(RFC 9485 §5.3). JavaScript가 거부하는 패턴은 false가 되고, \d나 전방 탐색처럼 JavaScript에만 있는 구문도 받아들입니다.
  • 숫자는 JSON.parse로 JavaScript 숫자가 됩니다. 253보다 큰 정수, 자릿수가 많은 소수, -0, 배정밀도 범위를 넘는 수는 비교와 표시 전에 값이 바뀌며 상태 줄에 목록이 나옵니다(예: 9007199254740993 → 9007199254740992).
  • JSON 구문 오류 메시지는 브라우저의 JavaScript 파서가 만든 것이라 문구가 브라우저마다 다릅니다.

다른 JSONPath 방언과의 차이

kubectl의 -o jsonpath 템플릿은 표현식을 중괄호로 감싸고 맨 앞의 $를 생략할 수 있습니다. 여기에 붙여 넣을 때는 중괄호 안쪽만 가져와 앞에 $를 붙이세요. Java의 Jayway JsonPath는 스크립트 표현식, =~, 경로 끝의 .length()를 받아들이지만 이 도구는 RFC 9535를 따르므로 위치를 표시하며 오류로 처리합니다. JSON의 구조를 바꾸려면 jq Playground를 쓰세요.

FAQ

JSONPath란 무엇인가요?

JSONPath는 JSON을 위한 쿼리 언어로, XML의 XPath에 해당합니다. 경로 표현식을 사용하여 JSON 문서에서 노드를 선택합니다. RFC 9535(2024)로 표준화되었습니다. kubectl 출력 템플릿, AWS Step Functions, 여러 API 테스트 도구가 그 변형을 사용합니다.

JSONPath 표현식에서 $는 무엇을 의미하나요?

$ 는 JSON 문서의 루트 요소를 가리킵니다. 유효한 JSONPath 표현식은 모두 $로 시작해야 합니다. 단독으로 사용하면 전체 문서를 선택하고, 이후에 선택자를 연결합니다(예: $.store.book[0].title). [*]는 배열의 모든 요소를 선택하므로 $.store.book[*].author는 모든 저자를 반환합니다.

필터 표현식은 어떻게 사용하나요?

필터는 [?표현식]으로 쓰고, @는 검사 중인 요소를 가리킵니다. RFC 9535에서는 괄호를 생략할 수 있어 $.store.book[?@.price < 10]과 $.store.book[?(@.price < 10)]은 같습니다. ==, !=, <, <=, >, >=로 비교하고, &&, ||, !로 조건을 조합하며, @.author.name 같은 중첩 경로, $로 시작하는 문서의 다른 값과의 비교, length(), count(), match(), search(), value() 함수를 쓸 수 있습니다. 문자열과 숫자는 같지 않습니다. 문자열 "9.99"로 적힌 가격은 10보다 작다고 판정되지 않습니다.

재귀 하강(..)이란 무엇인가요?

.. 연산자는 현재 노드의 모든 자손을 재귀적으로 검색합니다. 예를 들어 $..author는 중첩 깊이에 관계없이 JSON 트리 어디서든 모든 author 필드를 찾습니다.

"구문 오류 또는 지원하지 않는 구문"이 표시되는 이유는 무엇인가요?

표현식에 구문 오류(문자열이나 대괄호가 닫히지 않음 등)가 있거나 RFC 9535에 정의되지 않은 구문이 들어 있어서, 빈 결과를 돌려주지 않고 이유와 문자 위치를 표시하며 멈춘 것입니다. RFC 9535에 없는 구문의 흔한 예는 스크립트 표현식 [(@.length-1)]([-1] 사용), =~ 연산자(match()나 search() 사용), in / nin입니다. "매칭 없음"이 표시되면 표현식은 올바르고 JSON에 해당하는 값이 없다는 뜻입니다. 표현식에 .나 [ 같은 전각 문자가 있으면 JSONPath가 이를 이름의 일부로 읽으므로 상태 줄에서 알려 줍니다.

JSON이 어딘가로 전송되거나 저장되나요?

아니요. 조회는 이 페이지의 스크립트가 실행하며, JSON과 표현식을 서버로 보내지 않고 브라우저 저장소에도 쓰지 않습니다. 이용 통계에는 도구 이름과 동작(매칭 결과가 있는 조회 확정, 예시 클릭, 복사)만 기록하고 JSON이나 표현식은 기록하지 않습니다.