JSONのフォーマットとバリデーションを極める

Javascript Object Notation（JSON） は、現代のAPIやデータ転送において揺るぎない王者の地位を占めています。しかし、その厳格さゆえに、たった一つのカンマの位置ミスが本番環境のエンドポイント全体をクラッシュさせることもあります。

このガイドでは、JSONフォーマットのゴールデンルールを解説します。

JSONの構文ルール

通常のJavascriptオブジェクトとは異なり、JSONは非常に厳格です。これらのルールを破ると、パーサーは SyntaxError をスローします。

1. キーは必ずダブルクォートで囲む：'name': 'John' は無効です。"name": "John" と記述する必要があります。
2. 末尾のカンマは禁止：配列やオブジェクトの最後の要素の後にカンマを残すことはできません。
3. 関数やundefinedは使用不可：JSONに格納できるのは、文字列・数値・真偽値・配列・オブジェクト・null のみです。

有効なJSONと無効なJSON

厳格なJSONパーサーが求める記述を見てみましょう。

{
  "user": {
    "id": 1042,
    "isActive": true,
    "roles": ["admin", "editor"],
    "preferences": null
  }
}

これをJSスクリプトのように緩く書こうとすると、次のようになります：

// これは無効なJSON（ただし有効なJavascript）
{
  user: {
    id: 1042,
    isActive: true, // 末尾のカンマ
  }
}

バリデーションが重要な理由

マイクロサービスを連携させる際、無効なJSONを渡すと、受信側のサーバーで JSON.parse() が致命的な失敗を起こし、大規模な500エラーがスローされます。アプリケーションに組み込む前に、必ずJSONをリントしてフォーマットしましょう。

自動フォーマットツールを活用して、APIペイロードの安全性と構造的な健全性を検証しましょう！

データをテストする準備はできましたか？JSON Formatter & Validator にアクセスして、生の文字列を即座に見やすく整形しましょう！