無料 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 をドロップ、貼り付け、または Upload をクリックしてディスクから .json / .txt ファイルを読み込みます。Format JSON はドキュメントを再インデントします。不正な JSON は、クエリする前にパーサーメッセージとともにインラインで指摘されます。

2. 2

   エンジンを選ぶ

   RFC 9535（2024 年の IETF 標準、eval 不使用）がデフォルトです。jsonpath.com のような古いツールからコピーした式を実行していて、そこで見た結果に合わせたいときは Classic（Goessner）に切り替えてください。

3. 3

   JSONPath 式を入力する

   先頭の $ は表示済みです。.store.book[*].title のような子パス、[0] のようなインデックス、..author のような再帰下降、[?(@.price < 10)] のようなフィルターから始めてください。結果は入力するにつれてライブで更新されます。

4. 4

   結果ビューを切り替える

   Values は一致した値の JSON 配列を表示します。Paths は各一致の正規化パス（$['store']['book'][0]['title'] のような形式）を表示します。Both は両者を並べて表示するので、すべての値をドキュメント内の正確な位置に対応づけられます。

5. 5

   結果をコピーするかパーマリンクを共有する

   Copy result は出力をクリップボードに置きます。Copy link は 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 レスポンスからフィールドを抽出する

リクエスト ID、ネストしたリソース属性、名前のリストなどを、トラバーサルコードを書かずに JSON ペイロードから取り出します。ここでサンプルレスポンスに対してパスを構築し、Values ビューで欲しいノードを正確に返すことを確認してから、検証済みの式をアプリケーションやテストに貼り付けます。

統合テストのアサーションを書く

多くのテストフレームワークや契約テストツール（REST Assured、Karate、Postman）は、レスポンスボディをアサートするのに JSONPath を使います。ここでアサーションパスを下書きし、実際のレスポンスに対して正しいノードを選択することを検証して、テストにコピーします。テストスイートが赤くなる前に誤ったパスを捕まえられます。

パイプラインでデータ変換を設定する

Kubernetes、AWS Step Functions、Azure Logic Apps、多くの ETL ツールは、イベントペイロード内のフィールドを指すのに JSONPath を受け入れます。ここで代表的なイベントに対して正確なパスをプロトタイプし、解決することを確認してから、意図したところを指しているという確信を持ってパイプライン設定に組み込みます。

jsonpath.com の結果をプライベートに再現する

サーバー依存の評価ツールからの式があるが、自分のデータを第三者サイトに貼り付けられませんか？Classic（Goessner）モードに切り替えて JSON を読み込み、同じ結果をローカルに再現してください。ペイロードはブラウザーを離れないので、独自仕様のデータはあなたのマシンに留まります。

レガシー式を RFC 9535 へ移行する

RFC 9535 準拠をうたうシステムへ移行しますか？レガシー式を Classic モードで実行してから、RFC 9535 エンジンに切り替えて、まだ解析でき同じノードに一致するかを確認します。デュアルエンジン比較は、さもなければ本番で遭遇するフィルター、和集合、関数の違いを正確に指摘します。

なぜパスが誤ったノードを返すかをデバッグする

多すぎたり少なすぎたりするノードを選択するパスは、値だけからは推論しにくいものです。Paths ビューに切り替えてすべての一致の正規化された位置（正確な配列インデックス、正確なメンバーの連鎖）を見れば、オフバイワンのスライスやはぐれた再帰下降がすぐに明らかになります。

JSONPath を教える、またはレビューする

サンプルデータに対する動く式を開き、Values と Paths を切り替えながらセレクター単位で読み解き、学習者が何が選択され、どこにあるかの両方を見られるようにします。チートシートと作業済みの例は、コードレビューやオンボーディングのための構造化されたリファレンスになります。

エンジンとアルゴリズムのノート

RFC 9535 エンジン（jsonpath-rfc9535、依存ゼロ）

デフォルトエンジンは IETF RFC 9535 文法を直接実装します。式をトークン化して抽象構文木に解析し、ドキュメントに対して解釈します。パスのどこにも eval も Function コンストラクターもないので、eval インジェクションクラスのバグに対して免疫があり、厳格な Content-Security-Policy 下でも動作します。

Classic エンジン（jsonpath-plus、eval 無効）

Classic（Goessner）エンジンは jsonpath-plus で、patch 済みリリース（>= 10.4.0）に固定し、eval オプションを明示的に false に設定して構築されています。これは Goessner 方言の互換性を保ちつつ、ライブラリのデフォルトの eval ベースのフィルターパスに影響した CVE-2024-21534 および CVE-2025-1302 として追跡されたリモートコード実行ベクターを封じます。

正規化パスの生成

すべての一致は RFC 9535 正規化パスとともに報告されます。シングルクォートのブラケット表記（$['store']['book'][0]['title']）を使い、配列インデックスは裸の整数で表す正規形です。正規化パスはノードごとに安定かつ一意なので、同等の式は同一のパスを生みます。Paths ビューと Both ビューは曖昧さのない結果識別のためにこれに依存します。

遅延読み込みされるエンジンチャンク

両エンジンは最初に選択されたときにのみ別々の JavaScript チャンクとして読み込まれるので、初期ページは軽量に保たれ、使わないエンジンは決してダウンロードされません。エンジンを切り替えると、ページの再読み込みなしに現在のドキュメントに対して現在の式が即座に再評価されます。

ローカルファイルの読み込みと JSON 整形

Upload ボタンはブラウザーの FileReader API を使い、.json または .txt ファイルを完全にクライアントサイドで入力に読み込みます。ファイルは決して送信されません。Format JSON は入力を 2 スペースインデントで解析・再シリアライズし、整形不良の JSON が評価前に捕まるよう、解析エラーをインラインで表面化します。

URL ハッシュ経由のパーマリンク（決して送信されない）

共有状態は location.hash フラグメントにエンコードされ、JSON、式、アクティブなエンジン、結果ビューを運びます。ブラウザーはフラグメントを HTTP リクエストに含めないため、パーマリンクが開かれても go-tools.org サーバーはデータをまったく受け取りません。ハイドレーションは完全に受信者のデバイス上で行われます。

JSONPath のベストプラクティス

ターゲットに合うエンジンを選ぶ

下流システムが RFC 9535 準拠をうたうなら、RFC 9535 エンジンに対して書き、検証してください。古いツールやライブラリの式を再現または保守しているなら Classic（Goessner）を使ってください。誤った方言に対して検証することは、テスターで動いたパスが本番で失敗する最も一般的な理由です。

値だけでなく Paths ビューで検証する

Values ビューは何が一致したかを教え、Paths ビューはどこかを教えます。クエリが正しそうな値を返しても、誤った位置から選択しているかもしれません。はぐれた再帰下降や広すぎるワイルドカードです。正規化パスを確認して、式が意図したノードに正確に当たることを確かめてください。

スライスの排他的な終端に注意する

[0:2] はインデックス 0 と 1 を選択し、0 から 2 までではありません。終端境界は Python や JavaScript と同様に排他的です。オフバイワンのスライスエラーは最も頻繁な JSONPath バグです。Paths ビューを使って選択された各要素の正確なインデックスを読み、出荷前に境界を確認してください。

可能なら再帰下降より明示的なパスを優先する

$..price は便利ですが、意図しないものも含めてドキュメント内のあらゆる price に一致します。構造が分かっているときはパスを書き出して（$.store.book[*].price）、データが増えてもクエリが正確で予測可能なまま保ってください。.. は本当に不規則または未知の形状のために取っておきます。

フィルターでの空白とクォートを一貫させる

RFC 9535 はフィルター式に対して文法に正確に従いますが、従来の方言はよりゆるいです。文字列リテラルはシングルクォート（'fiction'）でクォートし、演算子は間隔を空け、寛容な解析に依存しないなど、フィルターをきれいに書いてください。そうすれば、最終的にどのエンジンやライブラリが実行しても同じ式が同じように評価されます。

よくある質問