Форматируйте и проверяйте JSON до ревью
Процедура ревьюера для нагрузок API и конфигурационных файлов: сначала форматирование, проверка структуры как дерева и детерминированное сравнение двух документов — без отправки данных куда-либо.
Проверьте точность и порядок
Проверьте результат на этих синтетических данных, прежде чем использовать личные данные.
Вставьте пример в просмотрщик JSON и откройте компактный вид. Вывод должен точно совпадать с этим текстом.
{"id":9007199254740993,"2":"b","1":"a"}
Целое оканчивается на 993, ключ 2 остаётся перед ключом 1. Для {"name":} ошибка находится в строке 1, столбце 9. Ограничения: 256 KiB, глубина 40, 10 000 узлов; повторяющиеся и зарезервированные ключи отклоняются.
Проверьте точность и порядокПочему форматирование идёт первым
Минифицированный JSON создан для машин: одна строка, без отступов, ключи в том порядке, какой выдал сериализатор. Заставить глаза ревьюить эту стену — значит позволить удалённому разрешению, перевёрнутому флагу или неожиданному эндпоинту проскользнуть.
Принтер форматирования — ещё и самая дешёвая проверка валидности из доступных. Документ, который не парсится, и в продакшене не заработал бы, а узнать об этом во вкладке ревью куда лучше, чем из журнала деплоя.
- Только читаемостьФорматирование сохраняет значения разобранного JSON, но может нормализовать escape-последовательности и запись чисел. Сравнивайте смысл, а не текст побайтно; для подписанных или чувствительных к байтам файлов сохраняйте оригинал.
- Глубина — сигналЕдинообразные отступы мгновенно показывают глубину вложенности, а глубина — то место, где прячутся ошибки конфигурации: опция, лежащая на уровень глубже, просто игнорируется.
- Поставляйте ожидаемую формуРевьюьте отформатированную копию, но поставляйте ту форму, которую ждёт система: pretty-printing — для людей, а не для сети.
Осматривайте дерево, а не только текст
Древовидное представление отвечает на вопросы, которые ревьюер реально задаёт, — какие есть ключи, какого типа каждое значение, насколько глубока структура, — без подсчёта скобок. Сырой текст ни на один из них быстро не отвечает.
При автоматической проверке вставленный JSON проверяется сразу, а набранный — после короткой паузы. Доступна и кнопка форматирования и проверки. Ошибки синтаксиса содержат позицию и подсказку; корректный ввод доступен как дерево, форматированный или компактный текст.
Сводка показывает число узлов и глубину. Зарезервированные ключи прототипа отклоняются, но это не сертификация безопасности приложения.
Дерево упрощает и разговор на ревью: «у третьего элемента items цена равна null» — комментарий, который любой проверит за секунды, а байтовое смещение в минифицированной строке — нет.
Открыть JSON Tree ViewerСравнивайте два документа детерминированно
Сравнение двух JSON глазами ломается, как только меняется порядок ключей. Структурный diff парсит обе стороны и сообщает, что действительно изменилось, — добавленные, удалённые и изменённые значения — независимо от порядка и пробелов.
В Text & JSON Diff есть режимы «Текст» и JSON. В текстовом режиме выбирайте умную точность либо сравнение по строкам, словам или символам. Режим JSON разбирает оба документа и сравнивает значения, поэтому перестановка ключей и изменение пробелов считаются идентичными.
Для обычного текста режим «Текст» позволяет игнорировать пробелы и нормализовать окончания строк; сводка считает добавления, удаления и изменения. Для данных и конфигураций используйте JSON, а если одна из сторон не является корректным JSON — переключитесь на текстовый режим.
Детерминизм важен не только удобством. Когда два ревьюера запускают одно и то же сравнение, они должны получить один и тот же ответ — иначе ревью превращается в торг об инструментах вместо решения об изменении.
Открыть Text & JSON DiffЗнайте пределы локальных сред
Это локальные среды с явными потолками, рассчитанные на нагрузки ревью, а не на массовую обработку данных. Зная потолок, вы понимаете, когда пора взять настольный инструмент.
Потолки существуют потому, что парсинг и diff работают в той же вкладке, где вы читаете; честный предел лучше зависшей страницы, а пространство сообщает о превышении явной ошибкой, а не молчаливым усечением.
- Потолок просмотрщикаJSON Tree Viewer принимает до 256 КиБ ввода, сорок уровней вложенности и десять тысяч узлов — с запасом хватает для ответа API или конфигурационного файла.
- Потолок diffТекстовый режим принимает до 256 тысяч символов с каждой стороны; режим JSON дополнительно ограничивает разбор до 256 КиБ UTF-8 на сторону. В обоих случаях число записей о различиях ограничено 10 000.
- За пределами браузераБолее крупные выгрузки — дампы баз данных, архивы журналов, сгенерированные фикстуры — территория настольного редактора или консольного инструмента, а не вкладки браузера.
Пятиминутный чек-лист ревью
Короткая процедура, которая ловит большинство проблем нагрузок до их попадания в продакшен.
Прогоняйте чек-лист и на образцовых данных производителя, и на живой нагрузке; фикстура, расходящаяся с реальностью, обесценивает ревью так же надёжно, как и баг.
- ПарсингСначала отформатируйте и распарсьте: убедитесь, что документ валиден, и бегло сверьте число узлов и глубину с ожиданиями.
- ОсмотрОсмотрите дерево: проверьте типы в листьях — числовой идентификатор, пришедший строкой, классическая ошибка интеграции.
- DiffСравните с последней известно-рабочей версией в JSON-режиме и прочитайте каждое сообщённое изменение до одобрения.
Оставьте нагрузку на своём устройстве
Нагрузки ревью часто содержат записи клиентов, токены или внутренние URL. Локальный просмотрщик держит этот материал во вкладке: текст парсится кодом, работающим на вашем устройстве, и никогда не передаётся в рамках операции.
Именно эта граница позволяет использовать эти инструменты с настоящими стейджинг-нагрузками во время ревью. Она не снимает ваших собственных обязательств: скачанные экспорты, содержимое буфера обмена и скриншоты дерева остаются в вашей ответственности и после выхода из пространства.
Если фрагмент нагрузки всё же нужно показать в ревью, вставьте минимальный фрагмент, демонстрирующий проблему, и сначала зачищайте идентификаторы — та же дисциплина, которую просят каналы поддержки.
Текущая спецификация выполнения
Редакция спецификации: 2026-10-05.2
Передача на той же странице ограничена 256 KiB текста UTF-8 и сроком 10 минут. У получателя есть собственные ограничения разбора и отображения.
JSON Tree Viewer и Structured Data Converter передают результат одному получателю на странице. Tree принимает только JSON; Converter и Text & JSON Diff — JSON, YAML или CSV. Открытие получателя не запускает преобразование автоматически.
Текст остаётся в памяти страницы и не попадает в URL, постоянное хранилище или аналитику. Закрытие, замена источника, уход, перезагрузка или истечение срока удаляют его. При истечении срока фокус возвращается к заголовку источника, только если он был внутри получателя.
Частые вопросы
Зачем форматировать JSON перед проверкой?
Как надёжно сравнить две JSON-конфигурации?
Каковы пределы локального просмотрщика JSON?
Почему локальная проверка — правдоподобное заявление.
Узнайте, как браузерные среды держат данные на устройстве, и как проверить путь данных любого инструмента, которым вы ревьюите.