JSONPath存在チェック — プロパティの存在でフィルタ

JSONPathの存在チェックを使って、プロパティが存在するかどうかに基づいて要素をフィルタする方法を学びます。オプショナルフィールド検出のための [?(@.key)] 構文を解説します。

Filters

詳細な説明

JSONPathにおける存在チェック

存在チェックは、値に関係なく特定のプロパティが存在するかどうかに基づいて配列要素をフィルタします。[?()] 内で比較演算子なしでプロパティを参照するだけで、存在テストが実行されます。

構文

$.array[?(@.property)]       // propertyが存在する要素
$.array[?(!@.property)]      // propertyが存在しない要素(一部の実装)

動作の仕組み

  • $.items[?(@.discount)]discount プロパティを持つアイテムを返します。
  • $.items[?(@.discount)].name はdiscountを持つアイテムの名前を返します。

「存在する」とは何か?

存在チェックはプロパティがオブジェクトに定義されていることを検証します。重要なニュアンス:

存在する? 備考
"hello" はい 空でない文字列
0 はい ゼロは有効な値
false はい* boolean false — 実装により異なる
null はい* nullは定義されているが空 — 実装により異なる
(欠落) いいえ オブジェクトにプロパティがない

一部の実装では nullfalse をfalsyとして「存在しない」と扱います。使用するJSONPathライブラリでテストしてください。

実用的なパターン

  1. 不完全なレコードの検索: $.users[?(!@.email)] — メールアドレスのないユーザー。
  2. エンリッチされたデータの検索: $.products[?(@.metadata)] — メタデータが付与された商品。
  3. 条件付き処理: オプショナルフィールドにアクセスする前にその存在を確認。

存在チェックと他の条件の組み合わせ

$.items[?(@.discount && @.price > 10)]

これはdiscountプロパティが存在し、かつ価格が10を超えるアイテムを選択します。

ユースケース

オプショナルフィールドを持つJSONデータを扱う場合に使用します。例えば、errorフィールドを含むAPIレスポンスの検索、追加メタデータでエンリッチされたレコードのフィルタリング、データセット内の不完全なエントリの特定などに活用できます。

試してみる — JSON Path Evaluator

フルツールを開く