カテゴリー: 開発ツール

JSON Diff

サイト側で企画したツールツールが見つからない?

2つの文書を貼り付けて、実際に変わった値だけを確認

2つのJSONを貼り付けると、a.b[2].cのようなパス付きで追加・削除・変更を表示。キーの順序やインデントは無視され、データはブラウザから出ません。

差分: 3
- version: 3
+ version: 4
変更 — version
- tags[0]: "draft"
+ tags[0]: "final"
変更 — tags[0]
+ paid: true
追加 — paid

このページの処理はすべてブラウザ内で行われます。アップロードは一切ありません。

このツールでできること

json diffが必要なのは、テキストの差分がJSONについて嘘をつくからです。キーを2つ入れ替え、ブロックのインデントを直し、片方をminifyしただけで、行単位のツールはデータが同一でもファイル全体を赤く塗ります。このツールはまずブラウザ自身のJSONパーサーで両方の文書を解析し、得られた構造どうしを比較するため、キーの順序や空白はそもそも判定に入りません。2つのテキストエリアには短いサンプルの組があらかじめ入っています。自分のペイロードに置き換えると、入力のたびに比較が再実行され、押すべき比較ボタンはありません。オブジェクトと配列は再帰的にたどられ、すべての差分にa.b[2].cのようなドットと角かっこの記法によるパスが付きます。ルートでの差分には$を使います。各差分は分類されます。右側にだけキーやインデックスがあれば追加、左側にだけあれば削除、両側にあって値が異なれば変更です。配列は長い方の長さまで位置ごとに比較され、余った位置は追加または削除として返ります。一覧の上には差分の総数が、下には差分ごとに1行が並び、パスと削除行・追加行が表示されます。各値はJSONテキストとしてプレビューされ、120文字で切って省略記号が付くため、1つの巨大なオブジェクトがページを飲み込むことはありません。同じJSONテキストにシリアライズされる値は等しいとみなされるので、負のゼロとゼロは行になりません。2つの文書が構造的に一致する場合はその旨をはっきり伝え、どちらかが解析できない場合はどちら側が失敗したかを示し、パーサー自身のメッセージをそのまま返します。多くの場合それだけで余分なカンマが見つかります。使う前に境界も知っておく価値があります。入力は貼り付けたテキストだけで、ファイルのアップロード、ドラッグ&ドロップ、URLの取得、フォルダーの比較はありません。パーサーは厳密なJSONのみを受け付けるため、JSON5、JSONC、コメント、末尾のカンマ、シングルクォートの文字列、NDJSON、YAMLは拒否されます。配列は位置だけで対応付けられるので、先頭に1つ要素を挿入すると以降のすべての位置が変更として報告されます。idによる対応付けも移動の検出もありません。機械可読な出力もありません。RFC 6902のJSON Patchも、JSON Merge Patchも、unified diffもありません。マージ、適用、左を採用、右を採用、共通の祖先との3方向比較もありません。整列した左右並列表示、シンタックスハイライト、折りたためるツリー、行番号もなく、無視リスト、キーのフィルター、パスの除外、大文字小文字を区別しないモード、数値の許容誤差もなく、スキーマ検証も入力の整形もなく、3つ以上の文書の比較もできず、コピーボタン、保存した比較、パーマリンク、ダウンロードもありません。両方の文書はブラウザ内で解析・比較されます。APIのペイロードや設定ファイルには鍵、トークン、顧客データが日常的に含まれるため、これは重要です。アップロードは行わず、訪問間で何も保存されません。

使い方

  1. サンプルの組を置き換えて、2つの欄にそれぞれの文書を貼り付けます。入力に応じて再計算され、比較ボタンはありません。
  2. 差分の件数と、その下の各行を確認します。各行にはa.b[2].cのようなパス(ルートは$)と、追加・削除・変更のラベルが付きます。
  3. どちらかが解析できない場合は、どちら側が失敗したかを示し、ブラウザのパーサー自身のエラーメッセージをそのまま表示します。

プライバシー

このツールはすべてブラウザ内で動作します。入力した内容がアップロード・保存・共有されることはなく、タブを閉じれば消えます。

よくある質問

JSON diffとは何ですか。
2つのファイルを行単位で比べるのではなく、先に両方の文書を解析してから値の違いを報告する比較のことです。この違いはセマンティックな差分、構造的な差分などと呼ばれ、ここでキーを並び替えたり片方を整形し直したりしても差分が出ない理由でもあります。
2つのJSONファイルをオンラインで比較するには。
サンプルの組を置き換えて、2つの欄に内容を貼り付けると、入力に応じて結果が更新されます。ただし入力は貼り付けたテキストのみで、ファイル選択、ドラッグ&ドロップ、URLの取得、フォルダーの比較はありません。.jsonファイルは先に開いてコピーする必要があります。
JSONの比較でキーの順序やインデントは影響しますか。
しません。オブジェクトはデータとして比較されるため、同じキーが違う順序で並んでいても同一と判定され、インデント、改行、minifyは両方が解析できた時点で無関係になります。例外は配列で、配列では順序に意味があるからです。
配列に1つ要素を挿入すると、なぜ以降すべてが変更になるのですか。
配列を位置ごとに比較しているからです。インデックス0どうし、1どうしという具合に長い方の長さまで比較するため、先頭への挿入は以降のすべての要素を1つ後ろの位置に押し出します。そのずれを吸収するidベースの対応付けも移動の検出もありません。
JSONは保存されたりサーバーに送られたりしますか。
いいえ。両方の文書はブラウザ内で解析・比較され、アップロードも訪問間の保存も行いません。APIのペイロードや設定ファイルには鍵、トークン、顧客の記録が日常的に含まれるため、まさにそこが要点です。