JSONPath テスター

JSONデータにJSONPath式をリアルタイムでテスト。結果をシンタックスハイライト付きで表示。フィルター・ワイルドカード・再帰下降に対応。無料・ブラウザ内で処理。

  • ブラウザ内で処理
  • ツールの入力を ZeroTool のサーバーにアップロードしません
  • 無料 · 登録不要
式は $ で始めます。どちらの入力を変更しても検索します。RFC 9535 のワイルドカード、負の添字、スライス、フィルターに対応します。構文エラーや未対応の構文は文字位置を表示し、空の式は結果を消します。
例
「例」を開いてクエリを選ぶと、式だけを置き換えて現在の JSON を検索します。書店データは再読み込みしません。「例」を閉じても式は変わりません。
初期表示の書店 JSON を編集するか、自分の JSON 値を貼り付けます。入力のたびに検索し、数値は JavaScript の精度で扱います。値が変わる数値(2^53 を超える整数など)はステータス行に表示します。このツール内で Ctrl+L(Mac は ⌘+L)を押すと、両方の入力と結果を消します。

JSON と JSONPath 式を入力すると、一致した値が表示されます。

結果 一致した値を表示し、正規化パスは表示しません。1 件ならその値、複数なら JSON 配列になります。マッチなしと入力エラーは別のメッセージです。長い結果はこの欄内でスクロールします。 「コピー」は表示中の JSON 全体をコピーします。文字列 1 件の引用符と 2 スペースの字下げも含みます。エラーやマッチなしの場合はコピーできません。失敗したら再度押してください。
詳しいガイドを読む JSONPathテスターオンライン:コードなしでJSONデータをクエリする
例・詳しい説明・よくある質問 実際の出力つきの例、ほかのツールとの違い、よくある質問。

JSONPath 構文リファレンス(RFC 9535)

  • $ — 文書のルート
  • .key、['key']、["key"] — オブジェクトのメンバー
  • [n]、[-1] — 配列の要素。負のインデックスは末尾から数える
  • [start:end:step] — スライス。例:[0:2]、[1:]、[::-1]
  • [0,2]、['title','price'] — 1 つの角括弧に複数のセレクター。結果はセレクターの順
  • [*]、.* — 配列のすべての要素、またはオブジェクトのすべての値
  • ..key、..[0]、..* — 任意の深さの子孫
  • [?@.price < 10] — フィルター。[?(@.price < 10)] とも書ける
  • [?@.isbn]、[?!@.isbn] — メンバーがある / ない
  • [?@.a.b == 'x' && @.c > $.min] — フィルター内の入れ子のパス、&& || !、$ で始まる絶対パス
  • length()、count()、match()、search()、value() — RFC 9535 が定める 5 つの関数

例:気象庁の天気予報 JSON

気象庁の天気予報ページが読み込む JSON(東京都、130000.json)から、2026 年 10 月 8 日 17 時発表分の地域名と天気だけを抜き出したものです(各地域の名前と天気以外は省略)。最上位が配列なので、式は $[0] から始まります。

[{"publishingOffice": "気象庁", "reportDatetime": "2026-10-08T17:00:00+09:00", "timeSeries": [{"areas": [
  {"area": {"name": "東京地方", "code": "130010"}, "weathers": ["晴れ", "晴れ", "晴れ 時々 くもり"]},
  {"area": {"name": "伊豆諸島北部", "code": "130020"}, "weathers": ["晴れ 夜遅く くもり", "晴れ", "晴れ 時々 くもり"]},
  {"area": {"name": "伊豆諸島南部", "code": "130030"}, "weathers": ["くもり 夜のはじめ頃 晴れ 三宅島 では 夜のはじめ頃 まで 雨", "晴れ 昼前 から 時々 くもり", "くもり 時々 晴れ"]},
  {"area": {"name": "小笠原諸島", "code": "130040"}, "weathers": ["くもり 夜のはじめ頃 晴れ", "くもり 時々 晴れ", "くもり"]}
]}]}]

$[0].timeSeries[0].areas[*].area.name は ["東京地方","伊豆諸島北部","伊豆諸島南部","小笠原諸島"] を返します。

今日の天気に「雨」を含む地域は $..areas[?search(@.weathers[0], '雨')].area.name で ["伊豆諸島南部"] です。search() は部分一致、match() は文字列全体の一致です。

全角スペースと全角記号

上の JSON の天気は「晴れ 時々 くもり」のように語の間が全角スペース(U+3000)です。半角スペースで書いた式は何も選びません。

  • $..areas[?@.weathers[2] == '晴れ 時々 くもり'].area.name(半角スペース)→ マッチなし
  • $..areas[?@.weathers[2] == '晴れ 時々 くもり'].area.name(全角スペース)→ ["東京地方","伊豆諸島北部"]

引用符の中の文字はデータと 1 文字ずつ比べるので、全角か半角かも区別されます。表記の揺れを吸収したいときは、search(@.weathers[2], '時々') のように変わらない部分だけで探します。

全角英数の状態で入力すると、記号も全角で入ることがあります。

  • 名前の途中の . はエラーになりません。$..areas[*].area.name は「area.name」という名前のメンバーを探すので マッチなし になり、ステータス行に 式に全角文字(.)があります。JSONPath はメンバー名の一部として読み、. [ ] * や $ としては扱いません。半角(ASCII)で入力し直してください。 と表示されます。
  • 角括弧の中の全角数字は構文エラーです。$[0].timeSeries[0].areas[0] は 構文エラーまたは未対応の構文: 角括弧の中に「0」は書けません(26 文字目) · 式に全角文字(0)があります。半角(ASCII)で入力し直してください。 になります。

制限事項

  • 構文エラーと RFC 9535 にない構文は「構文エラーまたは未対応の構文」と文字位置を表示します。RFC 9535 にない構文には次のものがあります:スクリプト式 [(...)]、=~、in / nin、他のライブラリの ~(メンバー名の取得)などの拡張。
  • $.store.book.length は length という名前のメンバーを選びます。配列にはそのメンバーがないため結果は空です。長さで絞り込むにはフィルター内で length() を使います(例:$[?length(@.book) > 3])。
  • 結果はマッチした値の一覧です。正規化パス($['store']['book'][0] など)は表示しません。
  • オブジェクトのメンバーは JavaScript が保持する順で返します。"10" のような配列の添字に見える名前が先に数値の昇順で並び、それ以外は JSON に書かれた順です。RFC 9535 §2.3.2.2 はこの順序を定めていないため、他の実装では変わることがあります。
  • 同じオブジェクトに同じ名前が 2 回あると、JSON.parse は後の値だけを残します。
  • 名前は符号位置ごとに比べ、Unicode の正規化はしません(名前セレクターは RFC 9535 §2.3.1.2。フィルター内の文字列比較もこのツールは同じ方法で行います)。全角と半角も別の文字です。
  • 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 や式は記録しません。