JSON フォーマッター

// JSON フォーマッターに関するよくある質問

JSONフォーマッターとは何ですか？

JSONデータを読みやすい形式に整形（Pretty Print・インデント付与）したり、不要な空白や改行を除去して圧縮（Minify）したりするツールです。本ツールはこれに加えて構文エラーの位置表示、リアルタイムでの整形プレビュー、インデント幅(2/4スペース・タブ)の切替に対応しており、APIデバッグや設定ファイル編集の効率を大きく上げます。

大きなJSONファイルも処理できますか？

ブラウザ上のJavaScriptで処理するため、数MB〜10MB程度のJSONであれば問題なく処理できます。それ以上の巨大ファイル（数十MB以上）になるとブラウザのメモリ消費が増えるため、Chromeなど主要ブラウザの最新版でメモリの余裕がある状態での実行をおすすめします。サーバー側の処理ではないため、機密データを含む大容量JSONも安全に整形できます。

データはサーバーに送信されますか？

いいえ、すべての処理はブラウザ内のJavaScriptで完結します。入力したJSONはサーバーに一切送信されず、ローカルストレージにも保存されません。APIキーやトークン、個人情報、社内設定など機密性の高いJSONも安心して整形・検証できます。ページを閉じればデータは完全に消えます。

JSONの構文エラーはどのように検出されますか？

入力されたJSONをリアルタイムでネイティブの`JSON.parse`で解析し、閉じ括弧の不足、余分なカンマ、引用符の閉じ忘れ、不正な値（undefined・関数など）、JSON仕様外のコメントなどがあればエラーメッセージと該当行・列を表示します。エラーの種類が分かるため修正が容易になります。

JSON5やJSONLにも対応していますか？

本ツールは標準のJSON（RFC 8259）に対応しています。コメント（//）やトレイリングカンマを含むJSON5、改行区切りのJSONL/NDJSONには現バージョンでは対応していません。これらの形式を扱う場合は、いったん標準JSONに変換してから本ツールをご利用ください。

インデント幅は何を選べますか？

2スペース・4スペース・タブの3種類から選択できます。GitHubやVS Codeのデフォルトは2スペース、Java/Pythonコミュニティでは4スペース、makefileやGo関連では タブが好まれます。プロジェクトのコーディング規約に合わせて切り替えてください。圧縮（Minify）モードも別途用意しています。

整形したJSONをコピーするには？

出力欄の上にあるコピーボタンを押すと整形結果がワンクリックでクリップボードにコピーされます。コピー後はそのままSlack・Notion・コードエディタ・JIRAコメントなどに貼り付けられます。一部のブラウザでは初回のみクリップボード書き込みの許可確認が表示されることがあります。

JSONをMinify（圧縮）するとどのくらい小さくなりますか？

整形済みのJSONをMinifyすると、インデントと改行が除去されるため一般に20〜50%程度サイズが縮みます。ネストが深いオブジェクトや配列ほど圧縮率が高い傾向にあります。APIレスポンスや設定をネットワーク経由で送る際にはMinifyすることで通信量とレスポンスタイムを削減できます。

文字化けや日本語が崩れる場合は？

本ツールはUTF-8で処理しているため、日本語・中国語・絵文字を含むJSONも正しく扱えます。文字化けが発生する場合は、入力元のJSONが別のエンコーディング（Shift_JIS等）の可能性があります。元ファイルをUTF-8で保存し直してから貼り付けてください。`\uXXXX`形式のUnicodeエスケープも標準JSONの範囲で適切に処理されます。

末尾の改行や末尾カンマでエラーになります

標準JSON（RFC 8259）では末尾カンマ（trailing comma）は許可されていないため、`[1, 2, 3,]`のような書き方はエラーになります。JSON5やJavaScriptオブジェクトリテラルでは許可されているため混同しがちです。エラーが出る場合は、末尾の余分なカンマを削除してください。末尾の改行や空白自体は問題ありません。