JSON差分比較

// JSON差分比較に関するよくある質問

キーの順序が違うだけで差分になりませんか？

なりません。本ツールはJSONを解析してから構造として比較するため、キーの出現順は無視されます。`{"a":1,"b":2}` と `{"b":2,"a":1}` は「差分なし」と表示されます。インデント幅や改行位置の違いも同様に無視されます。これがテキスト差分ツールとの最大の違いです。

「型変化」とは何ですか？

値の型そのものが変わったことを指します。たとえば `"replicas": 2` が `"replicas": "3"` になった場合、数値から文字列に変わっているので型変化として報告します。JSONスキーマのバリデーションを通らなくなったり、比較演算が意図通り動かなくなったりする原因になるため、単なる値の変更とは分けて表示しています。

配列の比較で「順番」と「キー」はどう使い分けますか？

要素の順序に意味がある配列（手順のリスト、時系列のログなど）は「順番で比較」、順序が保証されない配列（APIが返すレコードの一覧など）は「キーで突き合わせ」が適しています。後者では `id` のようなフィールドで要素を対応付けるため、並び順が変わっただけでは差分になりません。

突き合わせキーを持たない要素はどうなりますか？

キーで突き合わせるモードでも、指定したフィールドを持たない要素（数値や文字列だけの要素など）は位置で比較されます。オブジェクトとプリミティブが混在した配列でも動作しますが、そうした配列は設計上あいまいなので、可能ならデータ側を揃えることをおすすめします。

JSON Patch はそのまま使えますか？

RFC 6902 に沿った `op` / `path` / `value` の配列として出力するので、各言語のJSON Patchライブラリでそのまま適用できます。ただし配列に対する `add` と `remove` はインデックスの解釈が実装によって異なる場合があるため、配列を多く含む差分を適用する際は事前に動作を確認してください。

ドット記法とJSON Pointerの違いは何ですか？

ドット記法（`$.users[0].name`）は人が読みやすく、JSONPathの記法に近い形式です。JSON Pointer（`/users/0/name`）はRFC 6901の標準で、JSON Patchで使われるのはこちらです。差分を人に伝えるならドット記法、機械的に処理するならJSON Pointerを選んでください。

大きなJSONも比較できますか？

数千行程度であれば問題なく動作します。ただし再帰的に全要素を走査するため、数万行を超える巨大なファイルではブラウザが重くなる可能性があります。その場合は比較したい部分だけを抜き出すか、`jq` などのコマンドラインツールの使用をおすすめします。

差分がありすぎて読めない場合は？

まず配列の比較方法を「キーで突き合わせ」に変えてみてください。要素が1つ増減しただけで以降すべてがズレる、というのが差分が膨れ上がる最大の原因です。それでも多い場合は、比較したいオブジェクトの階層だけを取り出して貼り付けると見通しが良くなります。

JSONとして不正な場合はどうなりますか？

左右それぞれについて解析エラーを表示し、どちらのJSONに問題があるかが分かるようにしています。エラーメッセージにはブラウザのパーサーが停止した位置が含まれます。末尾カンマ・シングルクォート・コメントはJSONでは使えないため、これらがよくある原因です。

比較する2つのJSONはサーバーに送信されますか？

いいえ、解析も比較もすべてブラウザ内のJavaScriptで完結します。個人情報を含むAPIレスポンス、認証情報入りの設定ファイル、本番環境のデータなども外部に送信されません。ブラウザの開発者ツールのネットワークタブで、通信が発生していないことを確認できます。