JSONPath テスター
JSONデータにJSONPath式をリアルタイムでテスト。結果をシンタックスハイライト付きで表示。フィルター・ワイルドカード・再帰下降に対応。無料・ブラウザ内で処理。
- ブラウザ内で処理
- ツールの入力を ZeroTool のサーバーにアップロードしません
- 無料 · 登録不要
WeChat でスキャンしてシェア
例・詳しい説明・よくある質問 実際の出力つきの例、ほかのツールとの違い、よくある質問。
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 や式は記録しません。