仕組みと内部処理
ルート `$` から始まり、ドット/ブラケットキー、ワイルドカード(`*`)、負の配列インデックス(`[-1]`)、スライス範囲(`[start:end]`)、再帰降下(`..`)、および `eval()` を一切使わない安全な比較述語(`==`, `!=`, `<`, `<=`, `>`, `>=`, 真偽値)をトークン評価します。
使い方ステップ
左側の JSON 入力欄に任意の JSON オブジェクトまたは配列を貼り付けます。
`$.store.books[*].title` のような JSONPath 式を入力するか、クイックプリセットをクリックします。
整形された抽出結果 JSON と、各一致要素の正確な正規化パス(`$['store']...`)を確認します。
抽出した JSON 配列をテストコード、API モック、自動化スクリプト用にコピーします。
主な機能と特長
- ドット記法・ブラケット記法・配列ワイルドカード `[*]`・負のインデックス `[-1]`・スライス `[0:3]` に対応
- 任意のネスト階層を横断検索する再帰降下 `$..key` をサポート
- 安全性の低い `eval()` を使わずに `[?(@.price < 20)]` や `[?(@.inStock)]` などの条件フィルタを評価
- 抽出した各値が JSON ツリーのどのノードに由来するか正規化パスを並列表示
- 100% ブラウザローカル動作で機密 API レスポンスや Webhook ペイロードの検証も安心
計算ロジック・仕様・技術基準
式は `eval()` や `new Function()` を使わない再帰パス評価器で実行されるため、コードインジェクションの危険がなく厳格な CSP 環境下でも決定論的な走査順序で安全に動作します。
主な利用シーン
- Postman、Playwright、AWS Step Functions、Kubernetes/AWS CLI ワークフローで使うレスポンス抽出パスの事前検証
- 深くネストされた Webhook JSON ペイロードから特定の ID や配列要素をデバッグ抽出
- 設定デプロイ前に負の配列インデックス(`[-1]`)やフィルタ条件式の挙動を確認
- 大容量の OpenAPI / GraphQL JSON スナップショットをオフラインで探索
入出力の例・エッジケース
Filter Books Under $20
$.store.books[?(@.price < 20)].title
["Browser Cryptography", "Zero-Backend Architecture", "WebAssembly Field Guide"]
Filters objects first, then extracts only the requested property.
Recursive Price Extraction
$..price
[14.5, 24, 8.99, 19.5]
Collects matching keys at any depth.
仕様上の制限・精度に関するご注意
- • フィルタ述語は単一の二項比較または真偽条件(`@.prop op literal`)を評価します。`&&` / `||` による複合条件連結や `[?(...)]` 内の正規表現スクリプト呼び出しには現時点で非対応です。
- • 不正な JSON が入力された場合はブラウザ標準の `JSON.parse` による正確な構文エラー位置を報告します。
ブラウザ内ローカル処理とプライバシー保護
一般的なWebツールは文書やメディアを外部サーバーへ送信します。JSONPath クエリ&フィルタ式テスター(RFC 9535準拠) はお使いのブラウザタブ内のみで完結します:
入力テキストやファイルは端末内で処理され、外部の処理サーバーへアップロードされません。
作業内容や貼り付けたデータを保存・記録しません(通常の静的配信CDNリクエストのみ発生します)。
作業データはタブ内のメモリ上のみに保持され、リセットまたはタブを閉じると破棄されます。
よくある質問 (FAQ)
この JSONPath エンジンは内部で `eval()` を使用していますか?
いいえ。フィルタ条件式は任意の JavaScript として実行するのではなく、トークンパーサーによって明示的かつ安全に評価されるため予測可能でセキュアです。
負の配列インデックスはどのように動作しますか?
`$[-1]` は配列の最後の要素、`[-2]` は後ろから2番目の要素を選択します。また `[0:2]` のようなスライスは半開区間(開始を含み終了を含まない)として評価されます。
抽出された値が JSON のどこから取られたかパスを確認できますか?
はい。JSON 出力パネルの下部に、一致した各要素の正規化ブラケットパスが一覧表示されます。
JSON データに個人情報(PII)や認証トークンが含まれていても大丈夫ですか?
はい。パースとクエリ評価はすべてブラウザのメモリ(RAM)内だけで行われ、1バイトも端末の外に送信されません。