JSONPath Finder

// JSONPath Finderに関するよくある質問

JSONPathって何ですか？

JSON の中の特定の値がどこにあるかを文字列で表す方法です。例えば `{"user": {"name": "山田"}}` の「山田」は `$.user.name` と書けます。`$` はJSON全体の起点、`.` で階層を下に進み、`[0]` で配列の順番を指定します。APIドキュメント、テストコード、jq や JMESPath といったコマンドラインツールでよく使われます。

JSONPathはどんな時に使いますか？

APIレスポンスの構造を確認したいとき、Postman や Insomnia のテストアサーション用のパスを探すとき、jq コマンドを書く前の下調べ、CI/CD の設定ファイル内の参照場所を伝えたいとき、GraphQL の複雑な結果を扱うとき、などです。要は「JSON の中のどこに何があるか」を知りたい場面全般で活躍します。

深くネストされたJSONにも対応していますか？

はい、階層の深さや要素数に関わらず全パスを一覧表示します。10階層以上ある複雑な構造や、配列の中にオブジェクトが多数入っているデータでも問題ありません。目視で追いきれない大きなJSONほど、このツールの価値が上がります。

パスをコピーするにはどうすれば？

表示された一覧の各パスをクリックするだけで、そのパスがクリップボードにコピーされます。「コピーしました」の表示も出るので、成功したか一目でわかります。すべてのパスをまとめてコピーするボタンもあり、Excelや資料に貼り付けたい場合に便利です。

「ドット記法」と「ブラケット記法」の使い分けは？

ドット記法（`$.user.name`）は短くて読みやすいので、キー名が英数字だけのときはこちらが定番です。ブラケット記法（`$['user']['name']`）はキーに日本語・スペース・ハイフン・記号が含まれる場合に必須です。例えば `$.ユーザー情報.名前` はブラケット記法では `$['ユーザー情報']['名前']` になります。

配列の中の要素にもアクセスできますか？

はい、配列は `[0]`, `[1]`, `[2]` のように順番で指定します。例えば `$.users[2].email` は「usersリストの3番目の人のメールアドレス」を指します。ネストした配列や、配列の中にオブジェクトが入っている構造でも正しくパスを表示します。

値そのものも表示されますか？

はい、各パスの隣にそのパスが指す値も一緒に表示されます。「このパスに何が入っているか」を確認しながら選べるので、目的のパスを素早く特定できます。文字列・数値・真偽値・null など、すべての型に対応しています。

JSONにエラーがあった場合どうなりますか？

JSONの構文にエラーがあると、エラーメッセージが表示されて解析できません。カンマの過不足や括弧の閉じ忘れが原因のことが多いです。まずJSON整形ツールで整形すると、エラー箇所が特定しやすくなります。整形が通れば本ツールでも正しく解析できます。

JMESPathやjqとは違うのですか？

JSONPath・JMESPath・jq はどれもJSONから値を取り出す言語ですが、記法が少しずつ違います。本ツールで出力されるのはJSONPath形式で、Postman・多くのAPIドキュメント・多言語のライブラリで使えます。jq を使う場合は `.user.name` のようにドット始まり（`$` なし）になるので、頭の `$` を除いて使ってください。

入力したJSONはどこかに保存されますか？

いいえ、解析はすべてブラウザ内で完結し、入力データは外部に送信されません。ブラウザを閉じたり別のページに遷移するとデータは消えます。本番のAPIレスポンス、機密情報を含む設定ファイル、社内システムのデータでも安心して使えます。