JSON差分チェッカーは何を比較しますか?

2つのJSONドキュメントの書き方ではなく、含まれている内容を比較します。追加、削除、変更された値はすべてパスとともに一覧表示され、両方のエディターでマークされるため、APIレスポンス、設定ファイル、データのエクスポートが2つのバージョン間でどのように変わったかをひと目で確認できます。

使い方

  1. 1つ目のボックスに元のJSONを貼り付けるか入力し、2つ目のボックスに変更後のJSONを入力します。
  2. 差分がすぐに表示され、種類ごとに数が集計され、順番に一覧表示されます。
  3. 差分をクリックすると両方のエディターが該当箇所までスクロールします。または、エディター内のマークをクリックすると、一覧内の該当する項目に移動します。
  4. JSON Patchタブを開くと、同じ差分をJSON Patchの操作としてコピーまたはダウンロードできます。

どちらかのドキュメントが有効なJSONではない場合、どちらのドキュメントに問題があるかと、問題の行と列が表示され、該当するエディター内でマークされます。

差分として扱われるもの

  • キーの順序、インデント、空白、改行は差分として扱われません。{"a": 1, "b": 2}と{"b": 2, "a": 1}は同一です。
  • 型は差分として扱われます。数値の1と文字列の"1"は異なる値です。数値は値で比較されるため、1.0と1は同じです。
  • 配列では順序が考慮されます。idまたは_idフィールドを持つオブジェクトの項目は、そのフィールドを基準に照合されます。そのため、並べ替えられたリストでは、すべての行が変更されたと表示されるのではなく、移動した項目が表示されます。
  • その他の配列項目は値で照合されるため、リストの途中に挿入された値は1件の追加として表示されます。idのないオブジェクトは、配列内の位置で比較されます。
  • 長い文字列は値全体で比較されます。変更された文字列は、変更前と変更後のテキストで表示されます。

結果の見方

  • 追加された値は緑色、削除された値は赤色で表示され、変更された値は変更前の値に続けて変更後の値が表示されます。配列内で移動した項目には、移動前と移動後の位置が表示されます。
  • パスはドキュメント全体を表す$から始まるJSONPath形式で記述されます。$.items[2].nameは、itemsの3番目の項目にあるnameを表します。スペースなどの文字を含むキーは、$["名前"]のように角括弧で囲んで記述されます。
  • 削除された値のパスは元のドキュメント内の位置を示します。追加または変更された値のパスは変更後のドキュメント内の位置を示します。

JSON Patch

JSON Patchタブでは、JSON Patch標準(RFC 6902)の操作として差分が出力されます。操作はadd、remove、replace、moveで、それぞれ/items/0/priceのようなJSON Pointer形式のパスが指定されます。これらを順番に元のドキュメントへ適用すると変更後のドキュメントになり、ほとんどのプログラミング言語のライブラリで適用できます。patch.jsonとしてダウンロードできます。

仕組み

このツールはブラウザー内で両方のドキュメントを解析し、jsondiffpatchライブラリを使って比較します。このライブラリは最長共通部分列アルゴリズムで配列項目を照合し、移動した項目を検出します。貼り付けた内容がアップロードされることはありません。

例

  • {"price": 3}と{"price": 3.25}:$.priceが3から3.25に変更
  • ["有機", "地元産"]と["有機", "ビーガン", "地元産"]:$[1]に「ビーガン」を追加
  • {"hours": {"土": "8-14"}}と{"hours": {}}:$.hours.土を削除
  • id付きの商品リストを並べ替え、1つの価格を変更した場合:すべての行の変更ではなく、1つの項目の移動と1つの価格変更として表示

主な機能

  • キーの順序や書式を無視して、JSONの内容を比較
  • 追加、削除、変更、移動された値をパスとともに表示
  • 両方のエディターで差分をマークし、クリックすると該当箇所までスクロール
  • idまたは_idで配列項目を照合
  • コピーまたはダウンロードできるJSON Patch(RFC 6902)の出力
  • 構文エラーの行と列を表示
  • ブラウザー内で動作