オンラインJSONPathクエリツール。$.propertyによるプロパティアクセス、[n]による配列インデックス、[*]によるワイルドカード、[start:end]による配列スライス、?()による条件フィルタリング式をサポート。JSONとパスを入力するとリアルタイムでクエリを実行（400msデバウンス）。JSON整形ビューと整列テーブルビューの2つのモードを切り替え可能。8つのよく使われるパスの例を内蔵し、JSON構文エラーは自動修正可能。JSONファイルのアップロード、クエリ結果のダウンロード、キーボードショートカット操作、ローカル履歴の自動保存に対応。左右パネルの幅調整、フォントサイズ切り替えも可能。すべての解析とクエリはブラウザ内で完全にローカル実行され、データは一切アップロードされません。QAテスターのAPIアサーション、バックエンド開発者のログフィールド抽出、フロントエンド開発者のAPI検証作業に最適です。
以下の実用的な構文をサポートしています：①$.propertyまたは['property']でオブジェクトプロパティにアクセス；②[n]でインデックスによる配列要素へのアクセス（nは0から始まり、[-1]は最後の要素を表します）；③[*]または.*ワイルドカードで、配列のすべての要素またはオブジェクトのすべてのプロパティ値にマッチ；④[start:end]配列スライスで、指定範囲の要素を取得；⑤?(@.field op value)条件フィルタリングで、==/!=/>/</>=/<=の6種類の比較演算子に対応し、文字列と数値の比較をサポート。
?()条件フィルタリング式を使用します。例えば$.store.book[?(@.price < 80)]は価格が80未満の書籍をフィルタリングし、$.store.book[?(@.category == 'プログラミング')]はカテゴリがプログラミングの書籍をフィルタリングします。プロパティ名の前には@.を付けて現在の要素を表す必要があり、文字列値はシングルクォートまたはダブルクォートで囲んでください。
[0]で最初の要素、[-1]で最後の要素、[0:2]でインデックス0から1の最初の2要素を取得します（スライスは開始位置を含み終了位置を含まない半開区間です）。例えば$.store.book[0:3]は最初の3冊の書籍を取得します。
JSONビューは標準的なフォーマットでインデントされたJSON結果を表示し、完全なネスト構造を保持するため、完全なデータをコピーしたり閲覧したりするのに適しています。テーブルビューはオブジェクト配列の結果を自動的にプロパティ列ごとに整列して表示し、Excelのテーブルのような表示になるため、複数のレコードを閲覧する際により直感的で、全行のフィールド値の違いを素早く比較できます。単純型の結果もキーと値のペアで整列表示されます。
入力したJSONに構文エラー（カンマの不足、引用符の不一致、余分な末尾のカンマ、シングルクォートの使用など）がある場合、エラー箇所が赤色で表示され、「エラーを修復」ボタンが表示されます。クリックすると一般的なJSONの問題を自動的に修復します。Shift+Cmd/Ctrl+Fで先に整形を試すこともできます。整形でエラーが発生する場合はJSONに問題があるため、修復後にクエリを実行してください。
以下を確認してください：①JSONが有効かどうか（整形ボタンをクリックして検証できます）；②JSONPathのパスのスペルが正しいか、プロパティ名の大文字小文字は区別されます；③パスが存在するか（存在しないプロパティにアクセスするとエラーになります）；④フィルタリング式の構文が正しいか、括弧と引用符が対応しているか。
クエリボックスの右側にある「例」ボタン（下向き矢印）をクリックすると、ドロップダウンメニューに8つのよく使われるパスの例が表示されます。いずれかの例をクリックするとパス式が自動的に入力されます。まず「例」ボタンをクリックしてサンプルJSONデータ（書店データ）を読み込み、サンプルパスで動作を確認することをお勧めします。
すべてShift+Cmd（Mac）/Shift+Ctrl（Windows）のコンビネーションキーを使用します：Shift+Enterでクエリ実行、Shift+FでJSON整形、Shift+Oでファイルアップロード、Shift+Dで結果ダウンロード、Shift+Kですべての内容をクリア。ヘルプボタン（?アイコン）からいつでも完全なショートカット一覧を確認できます。
6種類の比較演算子をサポートしています：==（等しい）、!=（等しくない）、>（より大きい）、<（より小さい）、>=（以上）、<=（以下）。数値の比較は数値の大小で行われ、文字列の比較は辞書順で行われます。文字列値はシングルクォートまたはダブルクォートで囲む必要があります。
必須ではありません。ツールが先頭の$.を自動的に補完するため、store.book[0]と直接入力しても正常に動作します。システムが自動的に$.store.book[0]に正規化して実行します。ただし、標準JSONPath仕様ではルートノードを表すために$で始めることが推奨されています。
ツールは直近に入力したJSONをブラウザのローカルストレージ（localStorage）に自動的に保存します（最大200件の履歴）。次回ページを開いたときに前回の内容を自動的に復元するため、APIレスポンスを毎回再ペーストする必要がありません。クリアボタン（Shift+K）で現在の内容を消去できます。
はい、できます。ツールバーの「アップロード」ボタンをクリックするかShift+Oを押して、ローカルの.jsonまたは.txtファイルを選択すると、ファイルの内容が自動的に読み込まれて入力欄に設定されます。クエリ結果は「ダウンロード」ボタンまたはShift+Dでquery-result.jsonファイルとしてローカルに保存できます。
非常に適しています。APIデバッグ時に、APIレスポンスのJSONをツールに貼り付け、JSONPath式を対話的に調整してクエリ結果が期待通りになることを確認してから、検証済みの式をPostmanのテストスクリプト、JMeter JSON Extractor、自動テストフレームワークにコピーして使用できます。オンラインでのデバッグ時間を大幅に削減できます。
ありません。JSON解析、JSONPathパスマッチング、条件フィルタリング、テーブルフォーマットはすべてブラウザ内でJavaScriptによりローカル実行され、入力したJSONの内容がネットワークを通じていかなるサーバーにも送信されることはありません。ページを閉じた後はローカルのlocalStorageにのみ保存され（クリア可能）、機密性の高いビジネスデータやリリース前のAPIデータも安心して使用できます。
はい、使用できます。[*]を配列に使用すると配列のすべての要素を返し、オブジェクトに使用すると（例えば$.store.*）オブジェクトのすべてのプロパティ値からなる配列を返します。$.store.book[*].authorのようにプロパティと組み合わせて使用すると、配列内のすべての要素のauthorプロパティを抽出し、著者のリストを作成できます。
JSONPathはJSONドキュメントから指定されたデータを抽出するためのパス式言語で、XMLに対するXPathのような役割を果たします。API開発とテストでは、APIが返すJSONは階層が深くネストが多いことが多く、手動で展開して階層をたどってフィールドを探すのは非効率でエラーが発生しやすくなります。JSONPathを使用すると、1行の式で対象データを正確に特定して抽出できるため、APIデバッグ、自動テスト、データ抽出のシーンで開発者にとって必須のツールです。
JSONPathのコア設計思想は、パス記号を使用してデータの位置を記述することです：$はルートノード（JSONオブジェクト全体）を表し、ドット.または角括弧[]で子プロパティにアクセスし、[n]でインデックスにより配列要素にアクセスし、[*]ですべての要素にマッチし、[start:end]で配列の一部を切り出し、?()で条件により配列要素をフィルタリングします。この構文はシンプルですが表現力が高く、大多数のデータ抽出ニーズをカバーできます。
条件フィルタリングはJSONPathの最も実用的な機能の1つで、?(@.フィールド 演算子 値)の形式でフィルタリングロジックを記述します。例えば?(@.price < 100)はpriceフィールドが100未満の配列項目をフィルタリングし、?(@.status == 'active')はステータスがactiveのレコードをフィルタリングします。@は現在走査中の配列要素を表し、@.fieldで現在の要素の特定のフィールドにアクセスできるため、条件フィルタリングが非常に直感的になります。
なぜコード内で直接デバッグするのではなく、専用のJSONPathツールが必要なのでしょうか？API自動アサーションやデータ抽出コードを書くとき、JSONPathを間違えると、APIを繰り返し実行し、ログを出力し、コードを修正して再実行する必要があり、非常に効率が悪くなります。オンラインツールでの対話的なデバッグでは秒単位で結果を確認でき、式を調整すると即座にフィードバックが得られるため、正しいことを確認してからコードにコピーすることで、デバッグ時間を大幅に節約できます。
テーブルビューは多くの類似ツールと異なる本ツールの実用的な機能です：クエリ結果がオブジェクト配列の場合（これは最も一般的なAPIレスポンスのリスト形式です）、すべてのオブジェクトのキーを自動的に抽出してヘッダーとし、各行のデータを整列して表示します。Excelテーブルのような閲覧体験で、インデントされたJSON内で行ごとにフィールド値を探すよりもはるかに直感的で、複数のレコードのフィールドの違いを一目で比較できます。
JSONエラーの自動修復も実際の開発シーンを想定して設計された機能です：ログ、ドキュメント、チャットウィンドウからコピーしたJSONにはよく問題があります——シングルクォートが使われていたり、カンマが不足していたり、最後の項目に余分な末尾のカンマがあったり、プロパティ名に引用符がなかったりなど。手動で修復するのは面倒ですが、ツールの自動修復機能はほとんどの一般的なJSONフォーマットの問題をワンクリックで処理でき、1文字ずつエラーを探す必要がありません。
ローカル履歴は高頻度での使用を想定して最適化された細かな機能です：開発者は同じAPIを繰り返しデバッグすることが多く、ツールを開くたびにJSONを再ペーストするのは面倒です。ツールは直近の入力をブラウザのローカルストレージに自動的に保存し、次回開くときに前回の内容を自動的に復元します。200件の履歴があれば日常業務で十分に使用できます。すべてのデータは自分のブラウザ内にのみ存在し、アップロードされることはありません。
なお、本ツールがサポートしているのは実用的なコアJSONPath構文サブセット（プロパティアクセス、インデックス、ワイルドカード、スライス、条件フィルタリング）であり、日常の開発シーンの90%以上をカバーしています。再帰降下(..)、スクリプト式、複数条件の組み合わせなどの高度な構文には現在のところ対応していません。これらの高度な機能が必要なシーンでは、より完全な実装ライブラリを使用する必要がある場合があります。大多数のAPIデバッグとフィールド抽出のニーズには、現在の構文セットで十分対応でき、より軽量で高速です。
本ツールがサポートするすべての構文：
| 構文 | 説明 | 例の結果（サンプル書店JSON） |
|---|---|---|
$ | ルートオブジェクト、JSON全体を返す | 完全なstoreオブジェクト |
$.store.book[0] | book配列の最初の要素にアクセス（インデックスは0から始まる） | JavaScript上級プログラミング の書籍 |
$.store.book[-1] | 配列の最後の要素にアクセス | ユーザーエクスペリエンスの要素 の書籍 |
$.store.book[*] | ワイルドカード、配列のすべての要素を返す | 全3冊の書籍からなる配列 |
$.store.book[0:2] | 配列スライス、インデックス0から1を取得（半開区間） | 最初の2冊の書籍 |
$.store.book[*].author | 配列のすべての要素のauthorフィールドを抽出 | ["田中","鈴木","佐藤"] |
$.store.book[?(@.price < 80)] | 条件フィルタリング、price<80の書籍を抽出 | PythonとUXの2冊（価格79と59） |
$.store.bicycle.color | ドット記法でネストされたオブジェクトのプロパティにアクセス | "赤色" |
?()フィルタリング式でサポートされる演算子：
| 演算子 | 意味 | 例 |
|---|---|---|
== | 等しい（数値と文字列に対応） | ?(@.category == 'プログラミング') |
!= | 等しくない | ?(@.status != 'deleted') |
> | より大きい（数値比較） | ?(@.price > 100) |
< | より小さい | ?(@.price < 50) |
>= | 以上 | ?(@.age >= 18) |
<= | 以下 | ?(@.count <= 100) |
すべてのショートカットは Shift + Cmd(Mac)/Ctrl(Windows) コンビネーションキーを使用：
| 操作 | Macショートカット | Windowsショートカット |
|---|---|---|
| クエリ実行 | ⇧ + ⌘ + Enter | Shift + Ctrl + Enter |
| JSON整形 | ⇧ + ⌘ + F | Shift + Ctrl + F |
| ファイルアップロード | ⇧ + ⌘ + O | Shift + Ctrl + O |
| 結果ダウンロード | ⇧ + ⌘ + D | Shift + Ctrl + D |
| 内容をクリア | ⇧ + ⌘ + K | Shift + Ctrl + K |
本JSONPathクエリツールのJSON解析、パスマッチング、条件フィルタリング、テーブルフォーマット処理はすべてブラウザ内でJavaScriptにより完全にローカル実行されます。入力したJSONデータ、クエリしたパス、返される結果がいかなるサーバーにもアップロードされることはなく、記録、キャッシュ、クラウドストレージに保存されることもありません。入力履歴はブラウザのローカルストレージ（localStorage）にのみ保存され（最大200件）、クリアボタンまたはブラウザデータの消去により削除できます。機密性の高いビジネスフィールド、リリース前のAPIデータ、本番環境のログを含んでいても安心して使用でき、データ漏洩のリスクは一切ありません。
JSONPathパスが現在のJSON内で対応する値を見つけられないことを意味します。以下を確認してください：①プロパティ名のスペルと大文字小文字が正しいか（JSONは大文字小文字を区別します）；②ネスト階層が正しいか、中間層が存在するか；③配列インデックスが範囲外でないか；④整形ボタンをクリックしてJSON構造が期待通りか確認してください。
配列ではない値に対して[]インデックス、[start:end]スライス、?()フィルタリングを使用していることを意味します。これらの操作は配列に対してのみ使用できます。パスの対応する位置が実際には配列か単一オブジェクトかを確認し、まず$ワイルドカードやルートパスで実際の構造を確認してください。
以下を確認してください：①@の後にドットがあるか（@.fieldと書く必要があり、ドットを省略できません）；②文字列値がシングル/ダブルクォートで囲まれているか（?(@.name == tanaka)は不正で、?(@.name == 'tanaka')と書く必要があります）；③数値には引用符を付けないでください、付けると文字列比較になります；④比較演算子の両側に余分なスペースがないか。
JSONPath式の角括弧[]またはフィルタリングの括弧()が正しく対応していないことを意味します。閉じ]または)が書かれているか確認してください、特に複数の角括弧がネストしている場合は各[に対応する]があることを確認してください。
