レビュー前に JSON を整形して検査する

個人データを使う前に、この合成入力で実際の出力を確認できます。

JSON ツリービューアに例を貼り付け、圧縮表示に切り替えます。出力がこの文字列と完全に一致することを確認してください。

{"id":9007199254740993,"2":"b","1":"a"}

整数の末尾は 993、キー 2 はキー 1 の前のままです。{"name":} のエラー位置は 1 行 9 列です。上限は 256 KiB、深さ 40、10,000 ノード。重複キーと予約キーは拒否します。

ミニファイされた JSON は機械のためのものです。1 行、インデントなし、キーの順序はシリアライザ次第。その壁を目でレビューさせると、削除された権限、反転したフラグ、予期しないエンドポイントがすり抜けます。

整形は手元にある最も安価な妥当性チェックでもあります。パースに失敗するドキュメントは本番でも動かなかったはずで、それをレビュータブで知るほうがデプロイログで知るよりはるかにましです。

• 可読性のみ整形しても解析された JSON の値は保たれますが、エスケープ表記や数字の綴りが正規化されることがあります。バイト単位ではなく意味を比較し、署名付きファイルや元のバイトに依存するファイルは原本を保管してください。
• 深さはシグナル一貫したインデントはネストの深さを一目で示します。設定ミスは深さに潜むもので、1 段深く置かれたオプションは単純に無視されます。
• 期待される形で出荷レビューするのは整形済みコピー、出荷するのはシステムが期待する形です。整形は人間のためで、通信のためではありません。

ツリービューは、レビューアが実際に聞きたい質問——どんなキーがあるか、各値の型は何か、構造はどれくらい深いか——に括弧を数えずに答えます。生テキストはどれにも素早く答えられません。

自動チェックが有効なら、貼り付けた JSON はすぐに、入力した文字は短い間を置いて検査します。手動の整形・検証も使えます。構文エラーには位置と修正ヒントが表示され、有効な入力はツリー、整形、圧縮表示で確認できます。

概要にはノード数と深さを表示します。予約されたプロトタイプのキーは拒否しますが、アプリ全体の安全性を認証する検査ではありません。

ツリーはレビューの会話も平らにします。「items の 3 番目の要素の price が null」は誰でも数秒で検証できるコメントですが、ミニファイ行のバイトオフセットは違います。

キーの順序が変わった時点で、目視による 2 つの JSON の比較は破綻します。構造的な diff は両側をパースし、実際に変わった部分——追加、削除、変更された値——を順序や空白に関係なく報告します。

Text & JSON Diff にはテキストと JSON の二つのモードがあります。テキストでは自動判定、行、単語、文字の粒度を選べます。JSON では両側を解析して値を比べるため、キー順や空白だけの変更は同一と判定されます。

JSON 以外はテキストモードで空白を無視する設定や改行の正規化を使えます。概要には追加・削除・変更の件数が出ます。ペイロードや設定には JSON モードを使い、どちらかが正しい JSON でなければテキストモードに切り替えます。

決定性は便利さ以上の意味を持ちます。2 人のレビューアが同じ比較を実行したら同じ答えが得られなければなりません。さもなければレビューは変更についての判断ではなく、ツールについての交渉になってしまいます。

これらは明示的な上限を持つローカルランタイムで、バルクデータ処理ではなくレビュー用ペイロード向けのサイズです。上限を知れば、デスクトップツールに切り替えるべきタイミングがわかります。

上限があるのは、パースと diff があなたが読んでいるのと同じタブで動くからです。正直な上限はフリーズしたページよりましで、ワークスペースは超過を暗黙の切り捨てではなく明示的なエラーとして報告します。

• ビューアの上限JSON Tree Viewer は最大 256 KiB の入力、40 段のネスト、10,000 ノードまで受け付けます。API レスポンスや設定ファイルには十分です。
• diff の上限テキストモードは各側 256K 文字までです。JSON モードには各側 256 KiB の UTF-8 解析上限もあります。どちらも差分記録は最大 10,000 件です。
• ブラウザの外それより大きなエクスポート——データベースダンプ、ログアーカイブ、生成フィクスチャ——はブラウザタブではなくデスクトップエディタやコマンドラインツールの領分です。

ほとんどのペイロードの問題を本番到達前に拾う短い手順です。

本物のペイロードだけでなく、プロデューサのサンプルデータにもチェックリストを回してください。現実と食い違うフィクスチャは、バグと同じくらい確実にレビューを無効化します。

• パースまず整形してパース：ドキュメントが有効であることを確認し、ノード数と深度が期待どおりか一目見ます。
• 検査ツリーを検査：葉の型を確認します。数値の識別子が文字列で届くのは、典型的な統合バグです。
• diff最後の既知良好バージョンと JSON モードで diff し、報告された変更をすべて読んでから承認します。

レビュー用ペイロードには顧客レコード、トークン、内部 URL が含まれることがよくあります。ローカルビューアはその素材をタブに留めます。テキストはデバイス上で動くコードによってパースされ、操作の一部として送信されることはありません。

この境界があるからこそ、レビュー中に実際のステージングペイロードをこれらのツールで扱えます。ただし自分の責任まで消えるわけではありません。書き出したファイル、クリップボードの内容、ツリーのスクリーンショットは、ワークスペースを離れた後も慎重に扱うべきものです。

レビューでペイロードの断片を共有しなければならない場合は、問題を示す最小の抜粋だけを貼り、先に識別子を伏せてください。サポートチャネルが求めるのと同じ作法です。

仕様の改訂版: 2026-10-05.2

同一ページ内の受け渡しは UTF-8 テキスト最大 256 KiB、有効期間 10 分です。受け取り側には別途解析・表示の制限があります。

JSON Tree Viewer と Structured Data Converter は同じページ内の一つの対象に出力を渡せます。ツリーは JSON のみ、Converter と Text & JSON Diff は JSON・YAML・CSV を受け取れます。対象を開いても変換は自動実行されません。

テキストはページのメモリのみで保持し、URL・永続ストレージ・分析には送りません。閉じる、入力を置換、移動、再読み込み、有効期限で破棄します。期限切れ時に対象内にフォーカスがある場合のみ、元の見出しに戻します。