JSON差分ツール

使い方

1. 古いJSONを左のJSONに、新しいJSONを右のJSONに貼り付けます。
2. 配列がタグの一覧などの集合なら、配列の項目の順序を無視するにチェックを入れます。
3. 違いの表を読みます。各行には値のパス（JSONポインター）があります。パッチの確認が適用できると示したら、JSON Patch（RFC 6902）をコピーします。

文書の比べ方

2つの文書は値によって比べられます。JSONではオブジェクトはメンバーの集合と定められているため、オブジェクトの名前の順序は問題になりません。配列は順序のあるリストなので、オプションにチェックを入れない限り、項目の順序が問題になります。

数値は数として比べるため、1と1.0は同じです。RFC 8259のセクション6は、-(2^53)+1から(2^53)-1までの整数はどの実装でも同じように読まれると述べています。それより長い整数は、読み取られるときに丸められることがあります。

パスとパッチ

パスはJSONポインター（RFC 6901）です。各段階は名前か添字で、スラッシュで区切ります。タグのリストの最初の項目は/tags/0で、空のパスは文書全体を指します。名前の中のスラッシュは~1、チルダは~0と書きます。

JSON Patch（RFC 6902）は、add、remove、replaceの3つの操作を使います。削除される配列の項目は後ろから取り除かれるため、使われる時点で各添字が正しいままになります。追加される項目は、RFC 6902が配列の末尾と定める添字「-」を付けて追加されます。

配列の順序を無視する

このオプションにチェックを入れると、項目は位置にかかわらず値で対応付けられます。対応する相手のない項目は、追加または削除として報告されます。順序が違うだけでなく内容も違う配列は、パッチでは配列全体が置き換えられます。項目がどう動いたかを知らないと、項目を動かすだけのパッチは作れないからです。パッチは、配列を右の文書の順序で書きます。

よくある質問