JSON Diff — Порівняння JSON

Що робить JSON Diff

JSON Diff порівнює два розібрані значення JSON і показує, що змінилося за кожним шляхом. Він корисний для перевірки змін у відповідях API, правок конфігурації, оновлень фікстур, payload-ів feature flag, прикладів вебхуків, файлів перекладу та згенерованих даних, коли порядковий diff дає забагато шуму. Замість показу змін розділових знаків він рекурсивно обходить об’єкти й масиви та позначає шляхи як додані, видалені, змінені або незмінені. Оскільки обидві сторони спочатку розбираються як строгий JSON, синтаксичні помилки виявляються ще до порівняння, а це допомагає відрізнити некоректні вхідні дані від справжніх структурних відмінностей.

У звіті використовуються кольорові рядки, щоб суттєві зміни одразу впадали в око. Додані значення відображаються зеленим, видалені шляхи — червоним, змінені значення — бурштиновим, а незмінені примітивні шляхи — приглушеним текстом. Звіт у вигляді простого тексту можна скопіювати в задачу, pull request, нотатку про налагодження або огляд тестів, коли потрібно пояснити, чим відрізняються два payload-и.

Приватна робота у браузері

Уся обробка відбувається у вашому браузері за допомогою клієнтського JavaScript. Інструмент не завантажує на сервер фрагменти коду, значення конфігурації, згенеровані дані, текст запитів чи скопійовані приклади й не потребує облікового запису. Така суто локальна модель важлива для інструментів розробника, адже вставлений у них вміст часто схожий на справжні дані застосунку: відповіді API, журнали, зразки у формі змінних середовища, запити до бази даних, розмітка з чернеток або значення, скопійовані під час налагодження в продакшені. Локальна обробка зменшує ризики й пришвидшує роботу, бо немає звернень до мережі.

Інтерфейс навмисно компактний: ви вставляєте вхідні дані, налаштовуєте параметри, переглядаєте результат, копіюєте його й повертаєтеся до свого редактора. Проте результати все одно слід перевіряти, перш ніж комітити їх, публікувати чи використовувати у виробничому процесі. Інструменти в браузері чудово підходять для швидкої перевірки й підготовки, але не можуть знати всі конвенції проєкту, правила класифікації даних чи специфічні вимоги до валідації у вашому застосунку.

Практичні поради

Використовуйте цей інструмент для невеликих і середніх фрагментів JSON, які потрібно швидко зрозуміти. Дуже великі документи зручніше порівнювати у спеціалізованому редакторі, особливо коли масиви містять елементи в іншому порядку або записи без стабільних ідентифікаторів. Цей браузерний diff порівнює позиції в масивах напряму, тому елемент, вставлений на початок, може зробити наступні записи масиву зміненими, хоча ідентичність об’єктів концептуально та сама. Перед порівнянням нормалізуйте згенеровані часові мітки, випадкові ідентифікатори та значення, залежні від середовища, щоб справжні зміни контракту було легше помітити.