JSON整形・検証ツール

JSONはRFC 8259(実質的にはECMA-404と同一)で規定されています。ドキュメントは単一の値で、オブジェクト、配列、文字列、数値、true、false、nullのいずれかです。オブジェクトのキーは必ずダブルクォートで囲んだ文字列です。文字列にはダブルクォートのみを使い、ダブルクォート、バックスラッシュ、U+0020未満のすべての制御文字をエスケープする必要があります。そのため、文字列内のタブや改行は\tや\nと書きます。RFC 8259は、システム間でやり取りするJSONにUTF-8を使うことも求めています。

数値は10進数で、先頭のゼロ、16進数、NaN、Infinity、先頭のプラス記号は使えません。コメントや末尾カンマもありません。この最後の2つのルールが実際のエラーの大半を占めます。JavaScriptのオブジェクトリテラル、JSON5、多くの設定ファイルでは両方とも許可されているためです。下の一覧表は、よくある間違いをそれぞれフォーマッターと同じパーサーに通して作成したものです。

整形(プリティプリント)は改行とインデントを加えて構造を読みやすくします。JavaScriptプロジェクトではスペース2つが最も一般的で、Pythonのjson.dumps(indent=4)ではスペース4つがよく使われます。タブなら読む人が幅を選べます。圧縮(ミニファイ)は不要な空白をすべて削除します。APIのペイロードが小さくなり、ログや環境変数向けに1行へ収められます。

キーを並べ替えると、すべてのオブジェクトのメンバーが再帰的にアルファベット順に並びます。JSONのオブジェクトは定義上順序を持たないため、並べ替えても意味は変わりませんが、異なるシステムの2つのドキュメントを比較しやすくなります。なお、パース時に数値はJavaScriptの倍精度浮動小数点数になります。2^53(9,007,199,254,740,992)を超える整数、たとえ 一部のデータベースIDは、再整形すると精度が失われるため、文字列のまま保持してください。

整形したドキュメントは読みやすくなりますが、別の形式が必要になることもあります。オブジェクトの配列はJSON CSV変換でスプレッドシートになり、データ変換ではファイル全体をJSON、XML、YAML、CSVの間で変換できます。