JSONPathドット記法（$.key） — プロパティへの直接アクセス

JSONPathにおけるドット記法

ドット記法は、JSONオブジェクトのプロパティにアクセスする最も一般的な方法です。ピリオド（.）の後にプロパティ名を続けることで、簡潔で読みやすい式を記述できます。

構文

$.propertyName
$.parent.child.grandchild

動作の仕組み

以下のJSONドキュメントに対して：

{
  "user": {
    "name": "Bob",
    "email": "bob@example.com",
    "address": {
      "city": "Tokyo",
      "zip": "100-0001"
    }
  }
}

• $.user.name は "Bob" を返します
• $.user.address.city は "Tokyo" を返します
• $.user.email は "bob@example.com" を返します

各ドットはオブジェクト階層を1レベル深く進みます。深くネストされた値にアクセスするために、必要な数だけドットを連鎖させることができます。

ルールと制限

1. プロパティ名は有効な識別子である必要がある — スペース、ハイフン、特殊文字を含む名前にはブラケット記法が必要です（例：$["first-name"]）。
2. 大文字と小文字を区別 — $.User と $.user は異なるパスです。
3. 存在しないキーの場合は結果なし — プロパティが存在しない場合、式はエラーではなく空の結果セットを返します。

ドット記法 vs. ブラケット記法

特徴	ドット記法	ブラケット記法
構文	$.key	$["key"]
特殊文字	非対応	対応
可読性	高い	低い
動的キー	不可	可能

ドット記法は、シンプルで規約に沿ったプロパティ名に対して推奨され、JSONPathのチュートリアルやドキュメントで最も一般的に見られる形式です。