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. Live-diff обновляется по мере ввода; для больших входов (>200 КБ) переключается на ручную кнопку «Diff».

2. 2

   Уберите шум

   Нажмите пресет (Timestamps / IDs / Trace) или вставьте паттерны Extended JSON Pointer в «Игнорировать пути», чтобы убрать нерелевантные поля.

3. 3

   Выберите нужный вид

   Side-by-Side — для просмотра человеком, JSON Patch (RFC 6902) — для применимых машинами операций. Используйте «Поделиться ссылкой», чтобы отправить конфигурацию коллеге.

Типичные ловушки diff

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

Сравнение staging и production ответов; игнорирование timestamp и request ID, чтобы выявить только осмысленные изменения payload.

CI snapshot test failures

Вставьте actual против expected из падающего snapshot Jest/Vitest. Уберите шум и найдите реальное изменение за секунды.

Конфликты package-lock / yarn.lock

Решение merge-конфликтов через выравнивание зависимостей по name; порядок ключей и нерелевантные поля перестают быть шумом.

Аудит K8s / Helm values

Сопоставление envs, volumeMounts и ports по name. Ловит непреднамеренные изменения порядка vs реальные правки конфигурации.

Покрытие i18n переводов

Структурный diff en.json против zh.json для поиска недостающих или лишних ключей перевода без шума значений.

Просмотр Terraform / CDK plan

Сравнение plan-вывода между запусками; числовой допуск обрабатывает плавающую точку, «Игнорировать пути» убирает ARN и timestamp.

Технические детали

Соответствие RFC 6902 в выводе patch

Генерирует валидные операции JSON Patch (add/remove/replace) с путями RFC 6901. Проверено против fast-json-patch@3.x и rfc6902.

Итеративный обход

Обход с явным стеком (без рекурсии) ограничен 100 000 узлов и глубиной 64, чтобы предотвратить переполнение стека на враждебных входах.

Числовое равенство Object.is

По умолчанию числовой допуск 0 — используется Object.is, поэтому -0 и +0 различаются. Установите допуск > 0 для epsilon-равенства.

Лучшие практики

Фильтруйте до просмотра

Сначала добавьте «Игнорировать пути» (timestamp, ID, trace-поля), потом читайте diff. Просмотр шумных diff приучает глаз пропускать — и упускать — реальные изменения.

«По ключу» для логических множеств

Если массив представляет неупорядоченное множество (envs, users, dependencies), используйте «Сопоставлять по ключу». Sequential на логическом множестве почти всегда ошибочен.

Делитесь ссылкой, а не входами

Используйте «Поделиться ссылкой», чтобы отправить коллеге конфигурацию фильтра — никогда не вставляйте чувствительный JSON в общий документ. URL содержит только конфигурацию.

Часто задаваемые вопросы