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 のオブジェクトと書き方が似ているため、次の点で構文エラーになりやすくなっています。
- キーはダブルクォートで囲む:
{name: "tool"}は不可。{"name": "tool"}が正しい。 - 文字列はダブルクォートのみ:
'tool'は不可。 - 末尾のカンマは不可:
["a", "b",]は不可。 - コメントは書けない:
// 説明を含めるとエラーになります。 - 値がない項目は書けない:
undefinedは JSON にありません。
3. 整形と圧縮
- 整形(format):インデントを付けて読みやすくします。設定ファイルの確認や差分比較に向いています。
- 圧縮(minify):空白や改行を取り除き、1行にします。通信量を減らしたいときに使います。
JSON整形・圧縮・検証ツールで、どちらも貼り付けるだけで行えます。
4. エラーが出たときの確認手順
- ツールで「構文を検証する」を選ぶ
- 表示された行と列の付近を確認する
- 上の「よくある構文エラー」に当てはまるかを見る
エラーメッセージの位置は、ブラウザによって表示されない場合があります。その場合は、直前に編集した箇所を重点的に確認してください。
修正の例
次の JSON は、3か所に誤りがあります。
{
name: "tool",
'tags': ["json", "text",],
}
- 2行目:キー
nameがダブルクォートで囲まれていない - 3行目:
'tags'がシングルクォート、配列の最後に余分なカンマ - 4行目の直前:オブジェクトの最後に余分なカンマ
正しくは次のとおりです。
{
"name": "tool",
"tags": ["json", "text"]
}
検証ツールは最初に見つかった誤りだけを示します。1か所直したら、もう一度検証してください。
5. JSON と他の形式の使い分け
| 形式 | 特徴 | 向いている用途 |
|---|---|---|
| JSON | 入れ子の構造を表せる。ほとんどの言語が標準で対応 | API、設定、データ交換 |
| CSV | 表形式。表計算ソフトで開ける | 一覧表、集計データ |
| YAML | コメントが書け、人が読み書きしやすい | 設定ファイル |
| XML | 属性や名前空間が使える | 既存システムとの連携、文書 |
6. 数値の注意
JavaScript の仕様では、約9千兆(2の53乗)より大きな整数を正確に扱えません。IDなどの大きな整数は、JSON 内で文字列として書くのが安全です。
まとめ
JSON は単純な形式ですが、末尾のカンマやシングルクォートで簡単に壊れます。整形と検証を組み合わせると、原因を素早く見つけられます。