JSON差分比較
2つのJSONを構造で比較し、追加・削除・変更・型変化を一覧表示する無料オンラインツール。
💡 キーの順序とインデントの違いは差分になりません。値そのものが変わった箇所だけが表示されます。
キーの順序やインデントの違いは差分になりません。配列はID突き合わせにも対応し、JSON Patch(RFC 6902)としても出力できます。ブラウザ完結で入力したデータは送信されません。
2つのJSONをテキストではなく構造として比較するツールです。キーの順序やインデントが違うだけの差分は報告せず、実際に値が変わった箇所だけを一覧表示します。配列はIDでの突き合わせにも対応し、結果はJSON Patch形式でも出力できます。
JSON差分比較の機能と特徴
テキスト比較との違い
通常の差分ツールは文字列として比較するため、{"a":1,"b":2} と {"b":2,"a":1} のように中身が同じでもキーの順序が違うだけで全行が差分になります。インデントが2スペースと4スペースで違うだけでも同じことが起きます。
本ツールはJSONとして解析してから構造を突き合わせるので、こうした見た目の違いは無視され、値が本当に変わった箇所だけが残ります。
テキストとして比較したい場合は テキスト差分比較 をお使いください。
追加・削除・変更・型変化の違い
次の4つを色分けして表示します。
- 追加(Bにだけ存在するキー・要素)
- 削除(Aにだけ存在)
- 変更(同じ型で値が違う)
- 型変化(
"3"と3のように型そのものが変わった)
とくに型変化は重要で、APIの仕様変更で数値が文字列になった、設定ファイルで真偽値がクォートされてしまった、といった動くけれど壊れているバグの原因になります。
通常の差分ツールでは単なる値の変更と区別がつきません。
配列の差分が増えすぎる原因と対処
配列の比較方法を「順番で比較」と「キーで突き合わせ」から選べます。
順番で比較は先頭から位置どうしを見るため、要素が1つ増えると以降すべてがズレて差分だらけになります。
APIレスポンスのように順序が保証されない配列では、id などのフィールドで突き合わせる方が実態に合います。突き合わせキーは自由に指定でき、id 以外に key や name も使えます。
JSON Patch (RFC 6902) とは
差分を JSON Patch 形式で出力できます。これは add / remove / replace の操作列でJSONの変更を表現するIETFの標準仕様で、多くの言語にライブラリがあります。
「AをBに変えるには何をすればいいか」を機械可読な形で得られるため、APIのPATCHリクエストの組み立て、設定変更の適用スクリプト、変更内容の記録などにそのまま使えます。
パス表記はドット記法とJSON Pointerを切り替えられます。
本番データを比較しても外部送信されない理由
解析も比較もすべてブラウザ内のJavaScriptで完結し、貼り付けたJSONが外部サーバーに送信されることはありません。
個人情報を含むAPIレスポンス、認証情報を含む設定ファイル、本番とステージングの環境差分など、外部に出せないデータこそ比較したい場面で安心して使えます。
比較前にJSONを整えたい場合は JSON整形ツール、値の場所を調べたい場合は JSONPath検索 が便利です。
JSON差分比較に関するよくある質問
突き合わせキーを持たない要素はどうなりますか?
キーで突き合わせるモードでも、指定したフィールドを持たない要素(数値や文字列だけの要素など)は位置で比較されます。
オブジェクトとプリミティブが混在した配列でも動作しますが、そうした配列は設計上あいまいなので、可能ならデータ側を揃えることをおすすめします。
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に問題があるかが分かるようにしています。Chrome・Edge・Firefox ではエラーメッセージに位置も含まれます(Safari は含みません)。
末尾カンマ・シングルクォート・コメントはJSONでは使えないため、これらがよくある原因です。
JSON差分比較の使い方
-
2つのJSONを貼り付け
左側に比較元(A)、右側に比較先(B)のJSONを貼り付けます。「サンプル」ボタンで、キー順序・型変化・配列の並び替えを含む例を読み込んで動作を確認することもできます。
-
配列の比較方法を選ぶ
要素の順序に意味がある配列は「順番で比較」、APIレスポンスのように順序が保証されない配列は「キーで突き合わせ」を選び、突き合わせに使うフィールド名(
idなど)を指定します。 -
差分を確認してコピー
追加・削除・変更・型変化が色分けで一覧表示されます。「JSON Patch」に切り替えると、AをBに変えるための操作列をRFC 6902形式で取得でき、そのままPATCHリクエストや適用スクリプトに使えます。
カテゴリ データ形式