Что сравнивает средство проверки различий JSON?

Оно сравнивает содержимое двух документов JSON, а не способ их записи. Для каждого добавленного, удалённого или изменённого значения указывается путь, а само значение отмечается в обоих редакторах. Так вы сразу увидите, чем отличаются ответы API, файлы конфигурации или экспортированные данные в разных версиях.

Как пользоваться

  1. Вставьте или введите исходный JSON в первое поле, а изменённый — во второе.
  2. Различия появятся сразу: они будут сгруппированы по типу и перечислены по порядку.
  3. Нажмите на различие, чтобы прокрутить оба редактора до него, или нажмите на отметку в редакторе, чтобы найти соответствующую строку в списке.
  4. Откройте вкладку JSON Patch, чтобы скопировать или скачать те же различия в виде операций JSON Patch.

Если один из документов содержит некорректный JSON, инструмент укажет, в каком именно документе возникла ошибка, а также номер строки и столбца. Ошибка будет отмечена в соответствующем редакторе.

Что считается различием

  • Порядок ключей, отступы, пробелы и переносы строк не учитываются: {"a": 1, "b": 2} и {"b": 2, "a": 1} идентичны.
  • Типы учитываются: число 1 и строка "1" — разные значения. Числа сравниваются по значению, поэтому 1.0 и 1 считаются одинаковыми.
  • В массивах учитывается порядок. Элементы, которые являются объектами с полем id или _id, сопоставляются по этому полю. Поэтому при изменении порядка элементов будет показано, какие из них переместились, а не изменение каждой строки.
  • Остальные элементы массива сопоставляются по значению, поэтому значение, вставленное в середину списка, считается одним добавлением. Объекты без поля id сравниваются по их позиции в массиве.
  • Длинные строки сравниваются целиком: для изменённой строки показывается её прежний и новый текст.

Как читать результаты

  • Добавленные значения выделяются зелёным, удалённые — красным, а изменённые показываются в виде прежнего значения, за которым следует новое. Для перемещённого элемента массива указывается его прежнее и новое местоположение.
  • Пути записываются в формате JSONPath и начинаются с $, обозначающего весь документ: $.элементы[2].имя — это поле имя третьего элемента в массиве элементы. Ключи с пробелами и другими специальными символами записываются в квадратных скобках, например $["имя"].
  • Путь удалённого значения указывает на его место в исходном документе; путь добавленного или изменённого значения — на его место в изменённом документе.

JSON Patch

Вкладка JSON Patch представляет различия в виде операций стандарта JSON Patch (RFC 6902): add, remove, replace и move. Каждая операция содержит путь в формате JSON Pointer, например /элементы/0/цена. Если применить эти операции по порядку к исходному документу, получится изменённый документ. Библиотеки для большинства языков программирования могут применить их за вас. Скачайте результат как patch.json.

Как это работает

Инструмент разбирает оба документа в вашем браузере и сравнивает их с помощью библиотеки jsondiffpatch. Она сопоставляет элементы массивов алгоритмом наибольшей общей подпоследовательности и обнаруживает перемещённые элементы. Всё, что вы вставляете, остаётся в вашем браузере и никуда не загружается.

Примеры

  • {"цена": 3} и {"цена": 3.25}: изменилось значение по пути $.цена — с 3 на 3.25
  • ["органический", "местный"] и ["органический", "веганский", "местный"]: добавлено значение $[1] — «веганский»
  • {"часы": {"сб": "8-14"}} и {"часы": {}}: удалено значение $.часы.сб
  • Список товаров с идентификаторами, в котором изменился порядок элементов и цена одного товара: один перемещённый элемент и одна изменённая цена, а не изменение каждой строки

Возможности

  • Сравнение JSON по содержимому без учёта порядка ключей и форматирования
  • Добавленные, удалённые, изменённые и перемещённые значения с указанием путей
  • Отметки различий в обоих редакторах с переходом к ним по нажатию
  • Сопоставление элементов массива по полю id или _id
  • Вывод JSON Patch (RFC 6902) для копирования или скачивания
  • Номера строки и столбца для синтаксических ошибок
  • Работа в браузере