Назначение и возможности инструмента
Инструмент «Сравнение текста и JSON» предназначен для сопоставления двух версий текстовых данных или структуры JSON в режиме side-by-side (рядом друг с другом). Он позволяет быстро выявить изменения между исходным содержимым в поле «Оригинал» и обновленным вариантом в поле «Измененная версия». В процессе сопоставления наглядно подсвечиваются все добавления, удаления и модификации.
При работе с форматом JSON инструмент выполняет синтаксический анализ (парсинг) и форматирование содержимого, после чего формирует список конкретных изменений с указанием их точных структурных путей.
Данный инструмент необходим в следующих сценариях:
- Сравнение двух версий конфигурационных файлов.
- Сопоставление двух вариантов ответов API.
- Проверка данных JSON до и после проведения миграции данных.
- Сравнение двух версий коротких текстов.
- Работа разработчиков или аналитиков, которым требуются воспроизводимые структурные пути для обнаруженных изменений.
Входные данные и ограничения
Для проведения сравнения используются два поля ввода:
- Оригинал: исходный текст или JSON-содержимое. В поле отображается подсказка «Вставьте исходный текст или JSON сюда...».
- Измененная версия: измененный текст или JSON-содержимое. В поле отображается подсказка «Вставьте измененный текст или JSON сюда...».
Для каждого из этих полей установлено ограничение на объем разового ввода — не более 300 000 символов на одну сторону.
Пользователям доступны встроенные демонстрационные примеры для ознакомления с работой инструмента. При выборе текстового примера в левое поле загружается текст: «Инструменты BroBroGo работают прямо в браузере. Они быстрые, конфиденциальные и простые. Используйте их, когда нужно быстро проверить данные.». В правое поле загружается измененный текст: «Инструменты BroBroGo работают прямо в браузере. Они быстрые, конфиденциальные и точные. Используйте их, когда нужно быстро сравнить данные.».
При выборе примера JSON в левое поле загружается структура:
{
"name": "BroBroGo",
"plan": "free",
"tools": ["json", "regex", "hash"],
"private": true
}
В правое поле загружается структура:
{
"name": "BroBroGo",
"plan": "free",
"tools": ["json", "regex", "diff"],
"private": true,
"updated": 2026
}
```.
Инструмент поддерживает функцию быстрой очистки обоих полей ввода (при этом выводится сообщение «Обе стороны очищены») и функцию обмена содержимого левого и правого полей местами (при этом выводится сообщение «Стороны изменены местами»).
## Результаты сравнения и статистика
После обработки входных данных инструмент выводит результаты в блоке «Различия». Все обнаруженные изменения классифицируются по трем категориям:
* **Добавлено**: метка для обозначения добавленного содержимого.
* **Удалено**: метка для обозначения удаленного содержимого.
* **Изменено**: метка для обозначения модифицированного содержимого.
Дополнительно под каждым полем выводится статистическая информация: «Слева» для исходных данных и «Справа» для измененной версии.
## Режимы работы и правила обработки данных
Инструмент может функционировать в двух основных режимах: «Текст» и «JSON».
### Текстовый режим
В текстовом режиме сравнение может выполняться с разной степенью детализации:
* **Строки**: сопоставление ведется построчно.
* **Слова**: сопоставление ведется по отдельным словам.
### Режим JSON
При работе с JSON действуют особые правила обработки структуры:
* **Сравнение объектов**: ключи объектов сравниваются по их именам. Изменение порядка следования ключей в объекте не регистрируется как семантическое изменение данных.
* **Сравнение массивов**: элементы внутри массивов сопоставляются строго по их порядковым позициям.
## Обработка ошибок и критических ситуаций
В процессе работы инструмент контролирует корректность данных и время выполнения операций, реагируя на различные ситуации следующими сообщениями:
* Если различия между исходным и измененным текстом отсутствуют, выводится сообщение «Различий не обнаружено.».
* Если в режиме JSON левое поле содержит синтаксические ошибки, выводится сообщение «Некорректный JSON слева:» с последующим описанием ошибки.
* Если некорректные данные находятся в правом поле, выводится сообщение «Некорректный JSON справа:» с описанием ошибки.
* Если в режиме JSON структура данных верна, но изменения в значениях отсутствуют, отображается сообщение «Изменений в значениях JSON не найдено».
* При возникновении непредвиденного сбоя во время сопоставления выводится сообщение «Не удалось сравнить эти данные».
* Если размер введенных данных превышает установленные лимиты, выводится предупреждение «Объем данных слишком велик для этого инструмента. Попробуйте сравнить меньший фрагмент».
* Для предотвращения зависания интерфейса при обработке очень больших объемов данных результат может быть урезан. В этом случае выводится сообщение «Показан ограниченный результат, чтобы страница оставалась отзывчивой».
* Время выполнения операции сравнения ограничено 2,5 секундами. Если процесс превышает этот лимит, он принудительно останавливается, и пользователь видит сообщение «Сравнение занимает слишком много времени. Попробуйте уменьшить объем текста или переключитесь в режим строк».
## Конфиденциальность и безопасность данных
Безопасность пользовательской информации обеспечивается архитектурой инструмента: процесс сравнения текста и JSON полностью выполняется непосредственно в вашем веб-браузере. Никакие введенные данные не загружаются и не отправляются на серверы BroBroGo.
## Часто задаваемые вопросы (FAQ)
**В чем разница между текстовым режимом и режимом JSON?**
Текстовый режим сравнивает исходное содержимое по строкам или словам. Режим JSON сначала анализирует обе стороны, приводит их к единому формату и выводит список измененных путей, например `$.user.email`.
**Справляется ли инструмент с очень большим текстами?**
Медленные сравнения прекращаются через 2,5 секунды. Слишком большие объемы случайно вставленного текста обрезаются, чтобы страница не зависала.
**Игнорирует ли режим JSON порядок ключей в объекте?**
Структурированный список изменений сравнивает ключи объектов по имени, поэтому изменение только порядка ключей не считается семантическим различием. Массивы сравниваются строго по позициям элементов.