JSON 差分チェッカー
2つのJSONオブジェクトを比較し差異を可視化。RFC 6902 JSON Patchオペレーションとカラーツリーdiffを出力。ブラウザ内で処理。
- ブラウザ内で処理
- ツールの入力を ZeroTool のサーバーにアップロードしません
- 無料 · 登録不要
WeChat でスキャンしてシェア
例・詳しい説明・よくある質問 実際の出力つきの例、ほかのツールとの違い、よくある質問。
ユースケース
- バージョン間の API レスポンスの変化を確認する。
- PATCH HTTP エンドポイント用のパッチ操作を生成する。
- 設定ファイルの変更を監査する。
- アプリケーション内の予期しないデータの変化をデバッグする。
関連ツール:JSON 整形・構文チェック — diff 前に JSON を整形・検証する。
例
変更前:
{"name":"Alice","status":"pending","legacy_id":12345,"tags":["a","b","c"],"profile":{"age":30,"city":"Paris"}}
変更後(キーの順序が変わり、status を変更、legacy_id を削除、role を追加、最初のタグを削除):
{"status":"active","name":"Alice","role":"admin","tags":["b","c"],"profile":{"age":31,"city":"Paris"}}
JSON Patch:
[
{ "op": "replace", "path": "/status", "value": "active" },
{ "op": "remove", "path": "/legacy_id" },
{ "op": "replace", "path": "/tags/0", "value": "b" },
{ "op": "replace", "path": "/tags/1", "value": "c" },
{ "op": "remove", "path": "/tags/2" },
{ "op": "replace", "path": "/profile/age", "value": 31 },
{ "op": "add", "path": "/role", "value": "admin" }
]
キーの順序は結果に影響しません。name は位置が変わっても報告されません。このパッチを Python の jsonpatch 1.33 で適用すると、変更後のドキュメントになります。
例:郵便番号検索APIの正常応答とエラー応答
zipcloud「郵便番号検索API」のドキュメントにある 2 つのサンプル、郵便番号 0790177 の正常応答(status 200、住所 2 件)と、必須パラメータがないときのエラー応答(status 400)を比べます。
[
{ "op": "replace", "path": "/message", "value": "必須パラメータが指定されていません。" },
{ "op": "replace", "path": "/results", "value": null },
{ "op": "replace", "path": "/status", "value": 400 }
]
results は配列から null に型が変わったので、中の 2 件を 1 件ずつ削除するのではなく、/results を 1 回の replace で置き換えます。message も null から文字列に変わるだけなので replace です。半角カナの値は文字列としてそのまま比べます。
例:同じキーが 2 回ある JSON
手で編集した設定ファイルに、同じキーが 2 回書かれていることがあります。
差異なし — JSON は同一です。次のキーは同じオブジェクト内に複数あります。JSON.parse は最後の値だけを残し、その値だけを比較します:変更前 /営業時間。
JSON.parse は 2 つ目の "10:00-21:00" だけを残すため、2 つの文書は同じとみなされます。ステータスに重複したキーが出たら、どちらの値が正しいか原文で確かめてください。RFC 8259 は、オブジェクト内の名前は一意であるべき(SHOULD)としています(RFC 8259 第 4 節)。
配列の比較方法
配列は内容ではなくインデックスで比較されます。["a","b","c"] から最初のタグを外すと、remove /tags/0 1 件ではなく、置換 2 件と削除 1 件として表示されます。同じ配列から複数の要素を削除するときは、大きい添字から順に書き出します。例として、3 行あった注文明細が 1 行になり、数量も変わった場合:
[
{ "op": "replace", "path": "/items/0/qty", "value": 3 },
{ "op": "remove", "path": "/items/2" },
{ "op": "remove", "path": "/items/1" }
]
remove /items/2 の後も配列には 2 要素あるので、/items/1 はまだ存在します。小さい添字から書くと 2 つ目の削除が配列の末尾を越え、1 つでも操作が失敗するとパッチ全体が失敗します(RFC 6902 第 5 節)。
パスと JSON Pointer のエスケープ
パッチのパスは JSON Pointer(RFC 6901)で、~ は ~0、/ は ~1 と書きます。{"a/b":1,"m~n":2,"list":[1,2,3]} → {"a/b":2,"list":[1,2,3,4],"x":null} の結果:
[
{ "op": "replace", "path": "/a~1b", "value": 2 },
{ "op": "remove", "path": "/m~0n" },
{ "op": "add", "path": "/list/3", "value": 4 },
{ "op": "add", "path": "/x", "value": null }
]
ルートの型が異なる場合(オブジェクトと配列など)、パッチはドキュメント全体を置き換え、パスは空文字列 "" になります。ビジュアル差分はキーをドットでつないで表示します(profile.age、list.3)。
制限
- move と copy の操作は生成しません。キー名の変更は
removeとaddとして表示されます。 - オブジェクトの配列を
idフィールドで対応付けることはしません。 - 両方とも有効な JSON である必要があります。ステータス行にどちらの解析に失敗したかが表示されます(例:
変更前 JSON の解析エラー:Expected double-quoted property name in JSON at position 7。理由の部分はブラウザーが出す英語のままです)。 - 数値は JavaScript で解析してから比べるため、
1.0と1は同じとみなし、-0はパッチに0と書きます。2^53 を超え double で正確に表せない整数(9007199254740993など。9007199254740994や1e20は正確に表せます)と、とても長い小数は丸められ、1e400のように double の範囲を超える数値は Infinity になります。ステータスに一覧が出ます(最大 10 個、残りは件数)。パッチには読み取った値を書きます(1e400はnull)。 - 同じオブジェクト内で重複したキーは最後の値だけが残り、ステータスに表示されます。
- 約 1,900 階層(Node.js 22 で測定。ブラウザーによって異なります)入れ子になった文書は比較できず、ステータスにその旨を表示します。
- ツールのテストでは、生成したパッチを厳密な RFC 6902 実装(インストールされていれば Python の
jsonpatchも)で「変更前」に適用し、結果が「変更後」と一致することを確かめています。ランダムな 3,000 組の文書でも確認しています。
FAQ
RFC 6902 JSON Patch とは何ですか?
RFC 6902 は、JSON ドキュメントに適用する操作の並びを表す JSON 形式を定めています。各操作は 'op'(add / remove / replace / move / copy / test)、'path'(RFC 6901 の JSON Pointer)、必要に応じて 'value' を持つオブジェクトです。このツールが書き出すのは add、remove、replace の 3 種類だけです。
ビジュアル差分はどのように比べていますか?
入れ子の中まで再帰的に比べます。「変更後」にだけあるキーは追加(+)、「変更前」にだけあるキーは削除(−)、値が変わったキーは変更(~)として旧値と新値を並べます。ビジュアル差分のパスはドットでつないだ読みやすさのための表記なので、コードではパッチの JSON Pointer を使ってください。
ID が違うのに「差異なし」と出るのはなぜですか?
JavaScript は JSON の数値を 64 ビット浮動小数点数として読むため、2^53 を超え double で正確に表せない整数や、とても長い小数は丸められ、1830000000000000001 と 1830000000000000002 はどちらも 1830000000000000000 になります。比較は読み取った値で行いますが、両方の原文を調べ、丸められた数値と、同じオブジェクト内で重複したキーを JSON Pointer のパス付きでステータスに表示します(それぞれ最大 10 個、残りは件数)。
大きな JSON も比較できますか?
サイズの上限はなく、「比較」を押したときにこのタブ内で計算します。実際の限界は入れ子の深さで、約 1,900 階層(Node.js 22 で測定。ブラウザーによって異なります)入れ子になった文書はコールスタックが足りなくなり、比較できなかったことをステータスに表示します。
テキスト差分チェッカーとの違いは?
テキスト差分チェッカーは平文を行単位で比較します。この JSON 差分ツールは JSON の構造を理解し、テキストではなく値の意味で比較して、機械で読める JSON Patch を出力します。
JSON データはサーバーに送信されますか?
いいえ。2 つの JSON はこのブラウザーのタブ内で比較し、送信もブラウザーのストレージへの保存もしません。新しい入力の組み合わせを比較して差分が見つかったときに、ページのアクセス解析が利用イベントを 1 回記録します(ツール名と動作 diff だけで、JSON やパッチの内容は含みません)。