使い方
- 左の欄に JSON を貼り付けるか、
.jsonファイルをドロップします。入力したそばから右に整形結果が出ます(ボタンを押す必要はありません)。 - 「整形」はインデント(スペース 2・スペース 4・タブ)を付けて読みやすくし、「圧縮(1 行)」は空白と改行を取り除いてサイズを小さくします。
- 「キーを並べ替える」にチェックを入れると、すべての階層のオブジェクトのキーを A→Z(文字コード順)に並べます。2 つの JSON を差分比較する前にそろえておくと、順番の違いに惑わされずに中身の違いだけを見られます。
- 構文エラーがあると、何行目の何文字目かと原因・直し方を表示します。「入力欄のこの場所へ移動」を押すと、カーソルがエラーの文字に移ります。
- 「ツリー」に切り替えると、階層を開いたり閉じたりしながら中身を確認できます。キー名を押すと
$.users[0].nameのようなパスをコピーします。
JSON の文法のおさらい
JSON(JavaScript Object Notation)は RFC 8259 で決められたデータの書き方です。JavaScript のオブジェクトに似ていますが、次のように決まりがずっと厳しくなっています。
| 決まり | OK | NG |
|---|---|---|
| キーは必ずダブルクォートで囲む | {"id": 1} | {id: 1} |
| 文字列はダブルクォートだけ | "東京" | '東京' |
| 最後の要素の後にカンマを付けない | [1, 2] | [1, 2,] |
| コメントは書けない | — | // メモ |
| 使える値は 6 種類だけ | 文字列・数値・true・false・null・オブジェクト / 配列 | undefined・NaN・Infinity・日付オブジェクト |
| 数値は 10 進数で、先頭に余分な 0 を付けない | 7・0.5・1e3 | 07・.5・0x1F・+1 |
| 文字列の中の改行・タブはエスケープ | "1 行目\n2 行目" | 文字列の途中でそのまま改行 |
設定ファイルでコメントや末尾のカンマを使いたい場合は、JSONC(VS Code の設定など)や JSON5 といった別の形式が使われます。これらは JSON としてはエラーになるため、API に送るデータや package.json には使えません。
このツールの仕組みと特長
- 自前の構文解析: ブラウザ標準の
JSON.parseはエラーの説明が英語で、ブラウザによって書き方も違います。このツールは独自の解析器で 1 文字ずつ読み、「どこで・何が・どう直せばよいか」を日本語で表示します。全角スペースや全角の引用符・コロンなど、日本語の文書からコピーしたときに混ざりやすい文字も見分けます。 - キーの順番と数値をそのまま保つ: JavaScript のオブジェクトに一度変換すると
"10"のような数字のキーが先頭に移動したり、9007199254740993のような大きな整数が9007199254740992に変わったりします。このツールは元の並びと数値の表記を保ったまま整形します。 - 注意点の表示: 文法上は正しくても、同じキーが 2 回出てくる場合や、JavaScript で正確に扱えない大きな整数がある場合は注意として知らせます。
- 大きなファイルにも対応: 入力が大きいときは処理の間隔をあけて、入力の操作が重くならないようにしています。数 MB の JSON でもブラウザだけで整形できます。
具体例
エラーの例と表示
{
"name": "山田",
"tags": ["a", "b",],
}この JSON では、3 行目の "b" の後ろと ] の後ろの 2 か所に、JSON では書けない「最後の要素の後のカンマ」があります。ツールは最初に見つかった「3 行目 20 文字目: 最後の要素の後にカンマ(,)は付けられません」を表示します。1 つ直すと次のエラーが表示されるので、上から順に直していくと確実です。
文字列になった JSON
ログや API のレスポンスで "{\"id\":1}" のように JSON 全体が文字列として入っていることがあります。この形を貼り付けると「中身を JSON として開く」ボタンが出るので、押すとエスケープを外して整形できます。
よくある質問
- エラーの「列」は何を数えていますか?
- その行の先頭から数えた文字の位置です(1 文字目が 1)。全角文字も 1 文字として数えます。タブも 1 文字です。
- キーの並べ替えはどんな順番ですか?
- 文字コード(UTF-16)の順です。大文字が小文字より先に、数字が英字より先に並びます。
jq -Sや多くのプログラミング言語の標準的な並べ替えと同じ考え方です。配列の中身の順番は変えません。 - エスケープされた日本語(
あ)はどうなりますか? - 整形すると読める文字(
あ)に戻して出力します。改行やダブルクォートなど、JSON でエスケープが必要な文字だけはエスケープしたまま残します。 - JSON Lines(1 行に 1 つの JSON)は読めますか?
- JSON としては値が複数あることになるため、エラー(余分な文字)として表示します。全体を
[ ]で囲み、各行の終わりにカンマを付けると配列として整形できます。 - 入力したデータは送信されますか?
- 送信されません。解析と整形はすべてお使いのブラウザの中で行っているので、API キーや個人情報を含む JSON でも外部に出ることはありません。
最終更新: