Сравнение JSON и JSON-патч

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

1. Вставьте старый JSON в поле Левый JSON, а новый — в поле Правый JSON.
2. Отметьте Не учитывать порядок элементов массива, если массивы — это наборы, например списки тегов.
3. Прочитайте таблицу Различия. Каждая строка даёт Путь (JSON Pointer) значения. Копируйте JSON Patch, когда Проверка патча сообщит, что он применяется.

Как сравниваются документы

Два документа сравниваются по значению. Порядок имён в объекте не важен, потому что JSON определяет объект как набор членов. Порядок элементов массива важен, если опция не отмечена, так как массив — это упорядоченный список.

Числа сравниваются как числа, поэтому 1 и 1,0 равны. RFC 8259, раздел 6, говорит, что целые числа от −(2^53)+1 до (2^53)−1 читаются одинаково каждой реализацией, а более длинное целое при чтении может быть округлено.

Пути и патч

Путь — это JSON Pointer (RFC 6901): каждый шаг — имя или индекс, разделённые косой чертой. Первый элемент списка тегов — это /tags/0, а пустой путь — весь документ. Косая черта внутри имени записывается как ~1, а тильда — как ~0.

JSON Patch (RFC 6902) использует три операции: add, remove и replace. Удалённые элементы массива убираются с последнего к первому, чтобы каждый индекс оставался верным, когда его используют, а добавленные элементы дописываются с индексом «-», который RFC 6902 определяет как конец массива.

Игнорирование порядка массивов

Когда опция отмечена, элементы сопоставляются по значению, независимо от позиции. Элементы без пары сообщаются как добавленные или удалённые. Массив, который отличается, целиком заменяется в патче, потому что патч, который только перемещает элементы, должен знать, как они переместились. Затем патч задаёт массив в порядке правого документа.

Частые вопросы