JSONとは？基本を理解しよう
JSON（JavaScript Object Notation）は、データを構造化して表現するための軽量なテキストフォーマットです。もともとJavaScriptのオブジェクト記法から派生したものですが、現在では言語に依存しない汎用的なデータ交換形式として、Web開発をはじめ幅広い分野で使われています。人間にとって読み書きしやすく、コンピュータにとっても解析・生成が容易であるという特長が、JSONが広く普及した最大の理由です。
JSONの主な用途
Web APIの通信
現代のWebサービスでは、サーバーとクライアント間のデータのやり取りにJSONが標準的に使われています。REST APIやGraphQL APIのレスポンス形式としてJSONが採用されるケースがほとんどです。APIから返されるデータを確認する際に、整形ツールを使って読みやすく表示することで、デバッグの効率が大幅に向上します。
設定ファイル
package.json、tsconfig.json、.eslintrcなど、多くの開発ツールがJSON形式の設定ファイルを採用しています。設定ファイルの編集時に構文エラーがあると、ツールが正しく動作しなくなるため、バリデーション機能で事前にチェックすることが重要です。
データ保存・交換
NoSQLデータベース（MongoDBなど）ではJSON形式でデータを格納します。また、システム間のデータ連携やログの出力形式としてもJSONは多用されています。大量のデータをやり取りする際には、圧縮（ミニファイ）して通信量を削減することが一般的です。
JSON整形が必要な理由
APIから返されるJSONデータは、多くの場合改行やインデントのない圧縮された状態です。そのままでは構造を把握することが難しく、デバッグや内容確認に時間がかかります。整形ツールを使ってインデントを付与し、階層構造を視覚的に分かりやすく表示することで、データの内容をすばやく理解できるようになります。逆に、本番環境ではファイルサイズを小さくするために圧縮することが推奨されます。
よくあるJSONのエラーと対処法
JSONの構文エラーは開発中に頻繁に遭遇する問題です。主な原因と対処法を知っておくと、素早く修正できます。
代表的なエラー
- カンマの過不足 ─ 配列やオブジェクトの最後の要素の後ろにカンマを付けると（trailing comma）、構文エラーになります。また、要素間のカンマの付け忘れもよくあるミスです。
- 引用符の不一致 ─ JSONではキーと文字列値は必ずダブルクォーテーション（"）で囲む必要があります。シングルクォーテーションは使えません。
- 括弧の閉じ忘れ ─ ネストが深くなると、中括弧 { } や角括弧 [ ] の対応関係が分かりにくくなります。整形ツールでインデントを付けると、対応の不一致を発見しやすくなります。
- 不正な値 ─ JSONで使える値の型は、文字列・数値・真偽値（true/false）・null・オブジェクト・配列の6つだけです。undefinedやコメントは使用できません。
JSONとXMLの比較
データ交換フォーマットとしてJSONとよく比較されるのがXMLです。XMLはタグベースの記法で冗長になりがちですが、スキーマ定義やバリデーション機能が充実しており、厳密なデータ検証が求められる業務システムでは今も使われています。一方、JSONは記述量が少なく、JavaScriptとの親和性が高いため、Web APIやモバイルアプリでの利用ではJSON が主流です。用途に応じて使い分けることが大切です。
JSONを扱う際のヒント
- キー名は一貫したケース（camelCaseやsnake_case）を使い、チーム内で統一する
- ネストは3〜4階層以内に抑え、深くなりすぎないように設計する
- 日付はISO 8601形式（例: "2024-01-15T09:30:00Z"）で統一すると扱いやすい
- 大きなJSONファイルを扱う場合はストリーミング処理を検討する
- 機密情報（パスワードやトークン）をJSONに含めないよう注意する