JSON整形・フォーマットツール

JSON整形ツールの使い方

このJSON整形ツールは、3つの簡単なステップでJSONデータを見やすくフォーマットできます。初めての方でもすぐにお使いいただけます。

1. JSONを入力する：左のテキストエリアにJSONを貼り付けるか、.jsonファイルをドラッグ＆ドロップします。クリップボードからCtrl+V（Macの場合はCmd+V）で貼り付けることもできます。
2. インデント・モードを選択する：インデント幅は「スペース2」「スペース4」「タブ」から選択できます。モードは「整形（Pretty）」でインデント付きの見やすい形式に、「圧縮（Minify）」で改行やスペースを除去した最小形式に変換できます。
3. 結果をコピーする：右側に即時表示される整形済みJSONを「コピー」ボタンでクリップボードにコピーします。そのままエディタやAPIクライアントに貼り付けてご利用ください。

入力と同時にJSONのバリデーション（構文チェック）も自動で行われます。エラーがある場合は、エラー内容と発生箇所が日本語で表示されるため、修正箇所をすぐに特定できます。

JSON（JavaScript Object Notation）とは

JSON（JavaScript Object Notation）は、軽量なテキストベースのデータ交換フォーマットです。2001年にDouglas Crockfordによって提唱され、現在はRFC 8259（2017年12月発行）およびECMA-404として国際標準化されています。もともとJavaScriptのオブジェクトリテラル構文に由来しますが、言語に依存しない汎用フォーマットとして、Python、Java、Go、Ruby、PHPなどほぼすべてのプログラミング言語でパーサーが提供されています。

Web APIのリクエスト・レスポンス形式として最も広く使われているほか、package.json（Node.js）、settings.json（VS Code）、tsconfig.json（TypeScript）などの設定ファイル、NoSQLデータベース（MongoDBなど）のドキュメント形式としても活用されています。XMLと比較してデータサイズが小さく、構文がシンプルなため、モダンなWeb開発ではJSONが標準的なデータフォーマットとなっています。

JSONの基本構文（オブジェクト、配列、文字列、数値、boolean、null）

JSONで使用できるデータ型は以下の6種類です。

• オブジェクト：波括弧 {} で囲み、キーと値のペアをコロンで区切ります。キーは必ずダブルクォートで囲んだ文字列でなければなりません。例：{"name": "TxConv", "version": 1}
• 配列：角括弧 [] で囲み、カンマ区切りで値を並べます。異なるデータ型の混在も可能です。例：[1, "hello", true, null]
• 文字列：ダブルクォート "" で囲みます。シングルクォートは使用できません。エスケープシーケンス（\"、\\、\n、\uXXXXなど）が利用可能です。
• 数値：整数、浮動小数点数、指数表記に対応しています。先頭のゼロ（01など）やNaN、Infinityは使用できません。
• boolean（真偽値）：trueまたはfalseのみです。大文字（True、FALSE）は不正です。
• null：値が存在しないことを示します。小文字のnullのみ有効です。

JSON整形（Pretty Print）のメリット

JSON整形（Pretty Print）とは、改行とインデントを挿入してJSONデータを人間が読みやすい形式に変換する処理です。整形には以下のようなメリットがあります。

• 可読性の向上：ネストの深い複雑なJSONでも、インデントにより階層構造が一目でわかります。数百行を超える大きなJSONデータの確認に特に有効です。
• デバッグの効率化：APIレスポンスやログデータを整形することで、期待する値が正しくセットされているかを素早く確認できます。キーの欠落やデータ型の間違いも発見しやすくなります。
• コードレビューの円滑化：設定ファイルやテストデータをPretty Print形式で管理すると、Gitでの差分比較（diff）が行単位で明確になり、レビュアーが変更点を把握しやすくなります。

JSON圧縮（Minify）とは

JSON圧縮（Minify）とは、改行・インデント・余分なスペースをすべて除去し、JSONデータを最小サイズの1行に変換する処理です。データの内容や構造は一切変わりません。

• データサイズの削減：インデントや改行を除去することで、一般的にファイルサイズが20〜40%程度削減されます。大量のJSONデータを保存・転送する場合にストレージと帯域幅を節約できます。
• 通信の効率化：REST APIやWebSocketでJSONを送受信する際、Minify済みのデータを使うことで転送時間が短縮され、レスポンス速度の向上につながります。
• ログの一元管理：1行形式のJSONは、ログ管理ツール（Fluentd、Logstashなど）で1レコード＝1行として扱いやすく、検索やフィルタリングが容易になります。

よくあるJSONエラーと対処法

JSONを扱う際によく遭遇するエラーと、その原因・対処法を紹介します。

• 末尾カンマ（trailing comma）：配列やオブジェクトの最後の要素にカンマを付けるとエラーになります。例：{"a": 1, "b": 2,} は不正です。JavaScriptでは許容されますが、JSON仕様（RFC 8259）では禁止されています。
• シングルクォート：JSONの文字列はダブルクォートのみ有効です。{'name': 'TxConv'} はエラーになります。{"name": "TxConv"} に修正してください。
• コメント：//や/* */などのコメントはJSON仕様ではサポートされていません。コメント付きJSONが必要な場合は、JSON5やJSONC（VS Codeの設定で使用）を検討してください。
• キー名の引用符なし：{name: "TxConv"} のようにキーを引用符で囲まないとエラーになります。すべてのキーは"name"のようにダブルクォートで囲む必要があります。
• 制御文字の混入：コピー＆ペースト時に不可視の制御文字（BOMやゼロ幅スペースなど）が混入するとパースに失敗することがあります。テキストエディタで制御文字の表示を有効にして確認してください。

よくある質問（FAQ）