JSON チェッカー・ツリービューア

JSONのチェックでは「読み取れるか」と「そのまま伝わるか」の両方を確認します

JSONは、RFC 8259とECMA-404が定める文法に従ったテキストです。オブジェクトは波括弧 { }、配列は角括弧 [ ] で囲み、キーと文字列はダブルクォートで囲みます。値に使えるのは、文字列・数値・true・false・null・オブジェクト・配列だけです。この規則から1文字でも外れると、受け取る側のプログラムはドキュメント全体を読み込めません。JavaScriptの JSON.parse は、末尾のカンマが1つあるだけでも、シングルクォートが1つあるだけでもSyntaxErrorになります。

このチェッカーは、貼り付けたテキストを標準の文法どおりに厳密に読み取ります。文法が誤っていれば、解析が止まった行と列、その前後の行、閉じられていない括弧が開かれた位置を表示します。手作業で編集した設定ファイルや他の言語からコピーしたテキストによくある表記(コメント・末尾のカンマ・シングルクォート・引用符のないキー・Trueなど)は、自動でまとめて修正できます。文法が正しければ、折りたためるツリーで構造を表示します。値を選ぶと、その値までのパスと、値が占めるサイズも確認できます。

文法が正しくても、受け取るプログラムで値が変わることがあります。同じキーが2回出てくると、多くの場合は前の値が失われます。9007199254740993のような大きな整数は、JavaScriptでは9007199254740992として読み取られます。こうした箇所はエラーとは区別して、下の「注意」の一覧に別途まとめます。

JSONを検査して展開して確認したい場面

• APIのレスポンスを確認するとき: レスポンスが1行に長く連なって返ってくると、どの値がどこにあるのか分かりにくいものです。貼り付けるとツリーに展開され、必要な値をクリックして $.items[2].price のようなパスをそのままコピーできます。
• 設定ファイルを編集した後: package.json、tsconfig.json、VS Codeの設定のように手で編集するファイルは、カンマが1つ抜けただけでプログラムが起動しなくなります。保存する前に貼り付けてみれば、何行目なのかがすぐに分かります。tsconfig.jsonのようにコメントを許可するファイルを別のツールに渡すときは、自動修正でコメントを取り除いたコピーを作れます。
• ログやチャットからコピーしたJSON: メッセンジャーや文書エディタを経由すると、引用符が丸い引用符に変わったり、Webページの特殊な空白が混ざったり、Pythonの出力のようにシングルクォートやTrueが入っていたりします。目では区別できないこうした文字を、位置とあわせて指摘します。
• レスポンスが重い原因を探すとき: サイズマップは、選んだオブジェクトや配列の配下にある値ごとのバイト数を、面積で描きます。サムネイルをbase64で入れたフィールドや、同じ内容が繰り返される配列のように、サイズを押し上げている箇所が一目で分かります。
• ほかのシステムへ送る前に: 注文番号やツイートIDのような大きな整数、同じオブジェクト内の重複キー、対になっていない絵文字のエスケープは、文法チェックだけでは見つかりませんが、受け取る側で値が変わります。注意の一覧で事前に確認してください。

使い方

1. 原文の欄にJSONを貼り付けるか、「ファイルを開く」またはドラッグ&ドロップで.jsonファイルを開きます。入力が止まるとすぐに検査が始まり、Ctrl+Enter(Macは⌘+Enter)で即座に再検査することもできます。
2. エラーがある場合は、下にエラー診断と自動修正が表示されます。ステータス行の「エラー位置へ」を押すと、原文の欄のその文字にカーソルが移動します。自動で修正できる表記だけであれば、「N か所を修正して原文に反映」で一度に直せます。結果が気に入らなければ、ステータス行の「元に戻す」を押してください。
3. 文法が正しければ、左側のツリーで値を選びます。三角形のクリックやダブルクリックで枝を展開・折りたたみでき、矢印キーでも移動できます。原文の欄でカーソルを動かすと、ツリーもその値に追従します。
4. 右側の確認パネルで、パスの表記(JSONPath・JavaScript・Python・jq・JSON Pointer)を選び、「パスをコピー」を押します。「値をコピー」は、選んだ値だけを2スペースのインデント付きJSONでコピーします(文字列は引用符を除いた文字そのものです)。
5. 原文の欄の下にあるボタンで、2スペース・4スペースでの整形や1行への圧縮ができ、コピーや.jsonファイルとしての保存も行えます。整形するとき、数値は書いたとおりの表記を保ち、重複キーも削除しません。

エラーの案内と直し方

表の入力例をこのチェッカーに入れると、中央の列の案内が表示されます。位置は、解析が止まった文字を指します。カンマが抜けている場合だけは、止まった位置ではなく、カンマが入るべき位置、つまり直前の値のすぐ後を指します。行末でカンマを書き忘れるミスが最も多く、次の行の先頭文字よりも前の行の末尾を示すほうが原因を見つけやすいためです。

ドキュメントが終わっても括弧が開いたままの場合は、診断に「末尾に必要な閉じ文字」が内側から表示されます。{"data": [1, 2 であれば ]} です。ただし、ログや画面からコピーする途中で切れたレスポンスは、後半のデータが欠けた状態です。括弧だけを足して文法を整えるより、元のレスポンスを取得し直すほうが適切です。

自動修正が書き換えるものと書き換えないもの

自動修正は、JSON5・JSONCのような拡張形式、PythonやJavaScriptのコード、文書エディタを経由して生じた表記を、標準のJSONに書き換えます。行の配置とインデントはそのままで、該当する文字だけを置き換えます。コメントだけの行は、行ごと削除します。修正結果をもう一度厳密に検査し、通った場合にだけ「N か所を修正して原文に反映」のボタンが表示されます。修正できる表記があっても別のエラーが残る場合は、ボタンの代わりに、そのエラーを先に直すよう案内します。

NaN・Infinity・undefinedをnullに変えるのは、意味が変わる修正です。JSONの数値には無限大もNaNもないため、標準の範囲で使える位置はnullだけです。ただし、受け取るプログラムが「値なし」と「NaN」を区別する必要があるなら、文字列に置き換えるほうが適しています。16進数は、2⁵³−1を超えない場合にだけ10進数に変換します。

次のものは、あえて修正しません。先頭に0が付いた数値(04001)は、郵便番号のように文字列であるべきか、数値であるべきかが判断できません。カンマが重なった [1,,2] は、空の値を入れるつもりだったのかが分からず、途中で切れたドキュメントは、欠けた内容を復元できません。1行に1オブジェクトずつ書くJSONLは、修正する対象ではなく別の形式なので、JSON配列↔JSONL変換ツールを使ってください。 同じ行でカンマが抜けた配列の要素([1 -2]、["a" "b"])も直しません。Python や JavaScript では引き算や文字列の連結になり、カンマを入れると意味が変わるためです。カンマを補うのは、改行をまたぐ箇所とオブジェクトのキーの前だけです。

パスの表記5種類

ツリーで値を選ぶと、その値までのパスを5種類の表記で表示します。同じ値でも、使う場面によって表記が異なります。JSONPathはPostmanなどのAPIテストツールやデータベースのクエリに、JavaScriptとPythonの表記はコードに、jqはコマンドラインに、JSON PointerはJSON Patch(RFC 6902)やJSON Schemaの $ref に使います。JavaScriptとPython表記の data は、JSONを読み込んで入れた変数の名前だと考えてください。

ドット(.)で書けるキーの範囲は、表記ごとに異なります。JSONPathの標準(RFC 9535)は、英字とアンダースコアに加えてU+0080以上の文字もドット表記で書けるので、日本語のキーも $.住所.都市 と書けます。jqでドットが使えるのは、英数字とアンダースコアのキーだけです。そのため、日本語やハイフンを含むキーは .["住所"] のように角括弧で囲みます。JavaScriptは識別子の規則に従うので、日本語のキーはドットで、x-request-id のようにハイフンを含むキーは角括弧で書きます。JSON Pointerはキーを / でつなぐため、キーの中の ~ は ~0 に、/ は ~1 に置き換えます。ドキュメント全体を指すときは空文字列です。

文法は正しくても値が変わるケース

大きな数値。 JSONの文法は数値の桁数に上限を設けていません。ただしRFC 8259は、多くのプログラムが数値をIEEE 754 binary64(倍精度浮動小数点数)で扱うため、整数は−(2⁵³−1)から2⁵³−1までの範囲でしか、どこでも同じ値で読み取れないと記しています。それより大きな整数や、有効数字が長すぎる小数は、最も近いbinary64の値に変わります。このチェッカーは、書かれた文字と読み取られた値の有効数字を比較し、値が変わる数値だけを注意として表示します。

注文番号や会員番号のように計算に使わない大きな整数は、"1234567890123456789" のように文字列でやり取りするのが安全です。RFC 7493(I-JSON)も、binary64より広い範囲や精度が必要な数値は、文字列で表すよう勧めています。

重複キー。 RFC 8259は、1つのオブジェクト内のキーは一意であるべき(SHOULD)と定めています。そのうえで、重なったときは最後の値だけを使うプログラム、エラーにするプログラム、すべて渡すプログラムがあり、動作を予測できないと記しています。JavaScriptの JSON.parse とPythonの json は、後ろの値を採用します。このチェッカーは、重複キーをエラーにせず注意として表示します。ツリーでそのキーを選ぶと、先に出てきた同じキーへ移動するボタンが表示されます。

対のないサロゲート。 絵文字のようにU+FFFFを超える文字は、\ud83d\ude00 のように、2つのエスケープで1組になります。途中で切れて \ud83d だけが残ると、文法は通るものの、UTF-8に変換できない文字になります。その結果、受け取る側で文字化けしたり、エラーになったりします。I-JSONは、こうした文字を認めていません。

BOM。 メモ帳のようなエディタは、ファイルの先頭にBOM(U+FEFF)を付けることがあります。RFC 8259は、JSONを送信するときにBOMを付けてはならない(MUST NOT)とし、読み取る側は無視してもよい(MAY)としています。ところが、JavaScriptの JSON.parse とPythonの json.loads(文字列入力)は、BOMをエラーとして扱います。このチェッカーはBOMを読み飛ばして処理しますが、注意として表示し、整形・圧縮した結果からは取り除きます。

キーの順序。 JSONオブジェクトのキーの順序には意味がないと考えるのが原則ですが、人が読むときは書いた順序が大切です。JavaScriptのオブジェクトは、"2024" のように整数の形をしたキーを、ほかのキーより前に並べます(ECMAScriptのOrdinaryOwnPropertyKeys)。そのため、このチェッカーはブラウザの JSON.parse を使わず、独自の解析器で、書いた順序のままツリーを描きます。

サイズマップの見方

サイズマップは、選んだオブジェクトや配列の直下にある値ごとに、原文で占めるUTF-8のバイト数を測り、その分の面積で分割した図です。オブジェクトの場合は、キー名と値、その間の空白まで数えます。大きいものから正方形に近い形で配置し、最大30マスまで描きます。全体の0.4%に満たない小さな値は、斜線入りの「その他」の1マスにまとめます。マスの色は、ツリーの文字色と同じ種類別の色(オブジェクト・配列・文字列・数値・真偽値・null)です。

マスをクリックするとその値が選択され、オブジェクトや配列であればツリーが展開されて、マップも1段階内側に入ります。上部の位置表示(全体 › items › 0)をクリックすると、外側に戻ります。例の「注文APIのレスポンス」では、商品が3つ入ったitemsが最も大きく、その中に入るとオプションの多い商品がより大きく表示されます。実際のレスポンスでは、base64で入れた画像、毎回繰り返される長い説明、使っていないデバッグ用のフィールドが、大きなマスとして目立つことがよくあります。

間違えやすいケース

• JavaScriptのオブジェクトをJSONだと思い込む: コードに書いた {name: 'a', list: [1, 2,],} はJavaScriptでは正しいものの、JSONではありません。キーと文字列をダブルクォートで囲み、末尾のカンマを削除する必要があります。自動修正は、この3つを一度に処理します。
• Pythonの出力をそのままコピーする: print(dict) の結果は、{'ok': True, 'x': None} のようにシングルクォートとTrue・Noneを使います。JSONが必要なときは json.dumps() で出力してください。すでにコピーしてしまった場合は、自動修正で直せます。
• Windowsのパスのバックスラッシュ: "C:\Users" の \U はJSONのエスケープではないため、エラーになります。"C:\\Users" のように2つ重ねるか、"C:/Users" のようにスラッシュを使ってください。\n や \t で始まるフォルダ名は、エラーにならずに改行やタブに変わるので、さらに注意が必要です。
• 数値と数字に見える文字列: 42 と "42"、false と "false" は別の値です。ツリーでは、数値は紫、文字列は引用符付きの茶色で表示されるので、型が意図どおりか確認できます。
• JSONLを1つのドキュメントとして検査する: ログファイルのように1行に1オブジェクトずつ書いたテキストは、最初のオブジェクトの後で「JSONの値が終わった後に、文字が続いています」というエラーになります。1行ずつ検査するか、配列に変換してください。
• 文法チェックの通過をデータの検証だと思い込む: {"age": -5} や {"date": "2026-02-30"} は、正しいJSONです。必須キー・値の範囲・日付の実在は、JSON Schemaや受け取るシステムの検証で確認する必要があります。

制限と注意点

• 入力は5 MB(5,242,880バイト)まで検査できます。ファイルは、UTF-8(BOM付きを含む)とUTF-16のBOM付きファイルを読み取ります。ネストは500段階まで読み取ります。
• ツリーは一度に3,000行まで描画し、要素が多い配列は200個ずつ「次の…件を表示」で展開します。検索は、最初の10,000件まで数えます。
• 列番号はコードポイントで数えます。絵文字のようにUTF-16で2単位を使う文字も1列として数えるため、位置をUTF-16単位で数えるブラウザのエラーメッセージの「position」とは異なる場合があります。
• 自動修正は表記だけを書き換えます。NaN・Infinityをnullに変えるように意味が変わる修正もあるため、一覧を確認してから使ってください。先頭が0の数値、重なったカンマ、途中で切れたドキュメントは修正しません。
• JSON Schemaの検証、2つのJSONの比較、キーの並べ替えは行いません。インデントの整形と圧縮をさらに詳しく扱うには、JSON整形・圧縮ツールを使ってください。

出典

• 01IETF — RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Format§2 文法、§4 名前は一意であるべき(SHOULD)、§6 binary64と±(2⁵³−1)の相互運用性、§8.1 BOMを付けないこと・読み取り時は無視してよい、§8.2 対のないサロゲート — 2026-10-22確認
• 02Ecma International — ECMA-404: The JSON data interchange syntaxJSON文法の標準(空白はタブ・改行・復帰・スペースの4種類)
• 03IETF — RFC 7493: The I-JSON Message Format§2.1 サロゲート・非文字の禁止、§2.2 binary64を超える数値は文字列を推奨、§2.3 重複する名前の禁止(MUST NOT)
• 04IETF — RFC 9535: JSONPath: Query Expressions for JSON§2.5.1.1 member-name-shorthand(英字・アンダースコア・U+0080以上の文字)、シングルクォート・ダブルクォートの名前セレクタ
• 05IETF — RFC 6901: JavaScript Object Notation (JSON) Pointer/でつなぐパス、~は~0・/は~1、空文字列はドキュメント全体
• 06jq Manual.fooは英数字とアンダースコアのキーのみ、それ以外のキーは ."foo" または .["foo"]
• 07Pythonドキュメント — json: JSON encoder and decoder「Repeated Names Within an Object」: 同じ名前は最後の値だけが残る、NaN・Infinityを既定で受け入れる
• 08The JSON5 Data Interchange Format§1.1 JSONにない拡張: コメント、末尾のカンマ、シングルクォート、識別子のキー、16進数、前後の小数点、+記号、NaN・Infinity
• 09MDN — JSON.parse()末尾のカンマとシングルクォートはSyntaxError
• 10MDN — Number.MAX_SAFE_INTEGERJavaScriptが正確に表せる最大の整数 2⁵³−1 = 9,007,199,254,740,991
• 11ECMAScript Language Specification — OrdinaryOwnPropertyKeys§10.1.11.1 配列インデックスの形をしたキーを数値順に先頭へ並べる

よくある質問

あわせて使いたいツール