JSONPath再帰的降下演算子（..） — 深い探索

JSONPathにおける再帰的降下

ダブルドット演算子 .. はJSONドキュメントの深いスキャンを実行し、すべてのネストレベルを通じてマッチするプロパティ名や配列要素を検索します。JSONPathの最も特徴的な機能の一つです。

構文

$..propertyName     // 任意の深さで "propertyName" を検索
$..[0]              // 任意の深さのすべての配列の最初の要素
$..*                // ドキュメント全体のすべての値

動作の仕組み

深くネストされたJSONに対して：

• $..name は任意の深さにあるすべての name プロパティを返します。
• $..size はネストレベルに関係なく、すべてのサイズ値を返します。
• $..teams[0].name は各部門の最初のチーム名を返します。

一般的なパターン

1. すべてのIDを検索: $..id — レスポンス全体に散らばった識別子を収集するのに便利です。
2. すべての配列を検索: $..[*] と型チェックの組み合わせ。
3. 出現回数のカウント: $..key を評価し、結果の長さを確認します。

パフォーマンスに関する考慮事項

再帰的降下はドキュメントツリー全体を走査するため、非常に大きなJSON構造（メガバイト単位のデータ）では遅くなる場合があります。パフォーマンスが重要なアプリケーションでは、構造がわかっている場合は明示的なパスを推奨します。

比較表

式	結果
$.company.name	"Acme"（ルートレベルのみ）
$..name	すべての深さのすべての name 値
$..teams..name	チーム名のみ（スコープ付き降下）