JSONとは

JSON（JavaScript Object Notation）は、データを記述・交換するための軽量なテキスト形式です。JavaScriptから生まれましたが、現在はほぼすべてのプログラミング言語でサポートされており、WebAPIのデータ形式として世界標準となっています。

JSONの基本構造

JSONは2種類の構造で成り立っています。

  • オブジェクト：キーと値のペアを波括弧{}で囲んだもの
  • 配列：値のリストを角括弧[]で囲んだもの
{
  "name": "田中太郎",
  "age": 30,
  "isActive": true,
  "scores": [85, 92, 78],
  "address": {
    "city": "東京",
    "zip": "100-0001"
  }
}

JSONで使えるデータ型

  • 文字列：ダブルクォートで囲む。例："こんにちは"
  • 数値：整数・小数どちらも可。例：42、3.14
  • 真偽値：trueまたはfalse（小文字必須）
  • null：値なしを表す。例：null
  • オブジェクト：{}で囲む
  • 配列：[]で囲む

よくあるJSONのエラーと修正方法

  • 末尾カンマ：最後の要素の後にカンマをつけると無効。{"a": 1,} → {"a": 1}
  • シングルクォート：文字列はダブルクォートのみ使用可。{'key': 'value'} → {"key": "value"}
  • コメント：JSONにコメントは書けない。// コメントはエラー。
  • キーの引用符なし：{key: "value"} → {"key": "value"}

JSONの活用場面

  • REST API：サーバーとクライアントの間でデータをやり取りする標準形式
  • 設定ファイル：package.json、tsconfig.jsonなど
  • データ保存：NoSQL DB（MongoDBなど）の主要なデータ形式
  • ログ出力：構造化ログとして機械解析しやすい形式で出力