JSON Diff（差分）

JSON Diffとは？

// Two JSON documents that look different but are semantically equal
const a = '{"a":1,"b":2}';
const b = '{"b":2,"a":1}';

// Naive comparison — wrong
JSON.stringify(JSON.parse(a)) === JSON.stringify(JSON.parse(b));
// → false (key order differs)

// JSON Diff (this tool) — correct: key order is irrelevant
// → 0 differences

// JSON Patch (RFC 6902) for { "a": 1 } → { "a": 2 }
// [{ "op": "replace", "path": "/a", "value": 2 }]

主な機能

例

{"user":{"id":1,"name":"Ada","createdAt":"2024-01-01"}}

{"user":{"id":1,"name":"Ada Lovelace","createdAt":"2024-02-02"}}

{"a":1,"b":2,"c":3}

{"c":3,"a":1,"b":2}

[{"id":1,"qty":3},{"id":2,"qty":5}]

[{"id":2,"qty":5},{"id":1,"qty":4}]

{"items":[{"id":1,"price":29.99}]}

{"items":[{"id":1,"price":24.99}]}

使い方

1. 1

   両方のJSONドキュメントを貼り付ける

   元の（左）と変更後の（右）JSONを貼り付けます。ライブ差分は入力中にレンダリングされます；大きな入力（200KB超）は手動の「Diff」ボタンに切り替わります。

2. 2

   ノイズをフィルタリングする

   プリセット（Timestamps / IDs / Trace）をクリックするか、拡張JSON PointerパターンをIgnoreパスに貼り付けて不要なフィールドを除外します。

3. 3

   必要なビューを選択する

   人間によるレビューにはサイドバイサイド、マシン適用可能なopsにはJSON Patch（RFC 6902）を使用します。チームメートに設定を送るには「共有リンク」を使用してください。

よくある差分の落とし穴

diff a.json b.json   # text diff: 'everything changed'

JSON Diff (this tool): 0 differences

{"a": null} == {}   # collapsed by some tools

{"a": null} ≠ {}     # type-strict diff

Sequential diff: 4 modified

Match by key (id): 0 differences

{"id": 42} vs {"id": "42"}   # serialization bug

Diff reports 'modified (type)' with both values

tolerance=0:  0.30000000000000004 ≠ 0.3

tolerance=1e-9: equal

Diff: 47 modifications (45 are timestamps)

Add /createdAt, /updatedAt, /requestId to Ignore paths → 2 real changes

一般的な使用例

APIレスポンスのリグレッション

ステージングと本番のレスポンスを比較；タイムスタンプとリクエストIDを無視して意味のあるペイロード変更のみを表示。

CIスナップショットテストの失敗

失敗したJest/Vitestスナップショットから実際と期待を貼り付け。ノイズをフィルタリングして数秒で本当の変更を発見。

package-lock / yarn.lockの競合

依存関係をnameでアライメントしてマージ競合を解決；キーの順序と無関係なフィールドがノイズになりません。

K8s / Helmのバリュー監査

envs、volumeMounts、portsをnameでマッチング。意図しない順序変更と実際のconfig編集を検出。

i18n翻訳カバレッジ

en.jsonとzh.jsonを構造的にdiffして、値ノイズなしで欠損または余分な翻訳キーを検出。

Terraform / CDKプランのレビュー

実行間でプラン出力を比較；数値toleranceで浮動小数点演算を処理し、ignoreパスでARNとタイムスタンプを除外。

技術的な詳細

RFC 6902準拠のパッチ出力

RFC 6901パスを使った有効なJSON Patch ops（add/remove/replace）を生成。fast-json-patch@3.xとrfc6902 npmパッケージに対して検証済み。

反復トラバーサル

明示的スタックトラバーサル（再帰なし）で100,000ノードと深度64を上限とし、敵対的な入力でのスタックオーバーフローを防止。

Object.is数値等価性

デフォルトの数値toleranceは0 — Object.isを使用するため-0と+0は区別されます。イプシロンベースの等価性にはtolerance > 0を設定してください。

ベストプラクティス

レビュー前にフィルタリング

まずIgnoreパスを追加し（タイムスタンプ、ID、トレースフィールド）、その後差分を確認。ノイズの多い差分のレビューは、目を訓練して本当の変更を見逃させます。

論理セットにはキーマッチング

配列が順序なしセット（envs、ユーザー、依存関係）を表している場合は、キーでマッチングを使用。論理セットのSequential差分はほぼ常に間違っています。

データではなく共有リンク

フィルタ設定を同僚に送るには共有リンクを使用 — 機密JSONを共有ドキュメントに貼り付けないでください。URLにはconfigのみが含まれます。

よくある質問