JSON(JavaScript Object Notation)は、データを「キーと値」の組み合わせで表すテキスト形式です。Web API のレスポンス、設定ファイル、アプリ間のデータのやりとりによく使われています。名前に JavaScript とありますが、多くのプログラミング言語で読み書きできます。

1. 基本の書き方

JSON で使える値は次の6種類です。

  • 文字列("tool")
  • 数値(10、3.14)
  • 真偽値(true、false)
  • null(null)
  • 配列([1, 2, 3])
  • オブジェクト({"name": "tool"})

例えば次のような形です。

{
  "name": "json-formatter",
  "tags": ["json", "developer"],
  "public": true,
  "version": 2
}

2. よくある構文エラー

JavaScript のオブジェクトと書き方が似ているため、次の点で構文エラーになりやすくなっています。

  1. キーはダブルクォートで囲む:{name: "tool"} は不可。{"name": "tool"} が正しい。
  2. 文字列はダブルクォートのみ:'tool' は不可。
  3. 末尾のカンマは不可:["a", "b",] は不可。
  4. コメントは書けない:// 説明 を含めるとエラーになります。
  5. 値がない項目は書けない:undefined は JSON にありません。

3. 整形と圧縮

  • 整形(format):インデントを付けて読みやすくします。設定ファイルの確認や差分比較に向いています。
  • 圧縮(minify):空白や改行を取り除き、1行にします。通信量を減らしたいときに使います。

JSON整形・圧縮・検証ツールで、どちらも貼り付けるだけで行えます。

4. エラーが出たときの確認手順

  1. ツールで「構文を検証する」を選ぶ
  2. 表示された行と列の付近を確認する
  3. 上の「よくある構文エラー」に当てはまるかを見る

エラーメッセージの位置は、ブラウザによって表示されない場合があります。その場合は、直前に編集した箇所を重点的に確認してください。

修正の例

次の JSON は、3か所に誤りがあります。

{
  name: "tool",
  'tags': ["json", "text",],
}
  1. 2行目:キー name がダブルクォートで囲まれていない
  2. 3行目:'tags' がシングルクォート、配列の最後に余分なカンマ
  3. 4行目の直前:オブジェクトの最後に余分なカンマ

正しくは次のとおりです。

{
  "name": "tool",
  "tags": ["json", "text"]
}

検証ツールは最初に見つかった誤りだけを示します。1か所直したら、もう一度検証してください。

5. JSON と他の形式の使い分け

形式 特徴 向いている用途
JSON 入れ子の構造を表せる。ほとんどの言語が標準で対応 API、設定、データ交換
CSV 表形式。表計算ソフトで開ける 一覧表、集計データ
YAML コメントが書け、人が読み書きしやすい 設定ファイル
XML 属性や名前空間が使える 既存システムとの連携、文書

6. 数値の注意

JavaScript の仕様では、約9千兆(2の53乗)より大きな整数を正確に扱えません。IDなどの大きな整数は、JSON 内で文字列として書くのが安全です。

まとめ

JSON は単純な形式ですが、末尾のカンマやシングルクォートで簡単に壊れます。整形と検証を組み合わせると、原因を素早く見つけられます。