Форматирование и валидация JSON

Как отформатировать JSON

1. Вставьте ваш JSON в поле ввода или начните печатать.
2. Выберите размер отступа (2 или 4 пробела), если стандартный не подходит.
3. Отформатированный результат обновляется на лету, ошибки парсинга подсвечиваются.
4. Нажмите «Минифицировать», если нужна компактная версия в одну строку.
5. Скопируйте результат кнопкой копирования или выделите и скопируйте вручную.

Типичные ошибки JSON, которые находит инструмент

Чаще всего JSON не проходит проверку по одной из нескольких причин: лишняя запятая после последнего элемента, одинарные кавычки вместо двойных, ключи без кавычек или невидимый управляющий символ, попавший при копировании. Валидатор указывает позицию, где парсинг остановился, — обычно она находится сразу после настоящей ошибки.

Учтите, что JSON строже, чем объектные литералы JavaScript. Комментарии, висячие запятые и строки в одинарных кавычках допустимы в JS, но невалидны в JSON. Если вы скопировали объект из исходного кода, именно поэтому он часто не проходит валидацию.

Что на самом деле делает форматировщик JSON

По сути инструмент выполняет три задачи на одном экране: валидирует, красиво форматирует и минифицирует. Валидация разбирает ваш текст по тем же правилам, что и строгий JSON-парсер, и сообщает о первом, что не соответствует стандарту. Форматирование заново выводит разобранные данные с единообразными отступами и переносами строк, чтобы вложенность была наглядной. Минификация выводит их же, убрав каждый необязательный пробел и перенос строки.

Поскольку все три операции опираются на единственный разбор вашего ввода, результат всегда точно представляет данные, а не является заменой текста «найти и заменить». Порядок никогда не меняется, числа сохраняют своё значение, а строки — своё точное содержимое; между отформатированным и минифицированным видом меняются только пробелы между токенами.

Как всё работает целиком в вашем браузере

Когда страница загружается, вместе с ней в виде JavaScript загружается и логика форматирования. С этого момента каждое нажатие клавиши обрабатывается на вашем устройстве: текст в поле разбирается и заново сериализуется в памяти, а результат сразу записывается обратно в область вывода. Между этим нет ни одного запроса к серверу — именно поэтому результат появляется в тот же миг, как вы перестаёте печатать, даже на медленном соединении.

Полезный побочный эффект в том, что инструмент продолжает работать, если соединение оборвётся после загрузки страницы. Вы не обращаетесь к API, чтобы отформатировать JSON, — разбор делает сам браузер. Разработчикам, которые вставляют реальные данные, это важно: значит, данные физически не могут быть перехвачены по пути к несуществующему сервису форматирования.

Приватность при вставке реальных данных

JSON, с которым вы работаете каждый день, редко бывает безобидными примерами. Это ответы API с записями о клиентах, тела вебхуков с подписями, конфигурационные файлы со строками подключения или отладочные дампы с ещё живыми bearer-токенами. Вставка такого в онлайн-инструмент, который его загружает, была бы настоящей утечкой — и именно этот риск призван устранить данный форматировщик JSON.

Ничего из вставленного не передаётся, не сохраняется и не логируется. Здесь нет аккаунта, который мог бы связать данные с вами, и нет серверной истории, которую можно было бы затребовать или взломать. Когда вы закрываете вкладку, содержимое исчезает из памяти. Благодаря этому можно безопасно проверять и форматировать чувствительный JSON, который вам никогда не разрешили бы отправить третьей стороне.

Повседневное применение для разработчиков и аналитиков

Самая частая задача — сделать нечитаемый ответ API удобочитаемым: сервис возвращает одну длинную минифицированную строку, вы её вставляете, и вложенная структура превращается в то, что можно просмотреть глазами и отладить. Почти так же часто проверяют, что отредактированный вручную конфиг, манифест пакета или инфраструктурный шаблон всё ещё парсится, прежде чем закоммитить его и запустить неудачный деплой.

Инструмент так же удобен и в обратную сторону. Когда JSON нужно вставить в переменную окружения, команду в консоли, столбец базы данных или тело запроса в тесте, минификация сворачивает его в одну компактную строку. Аналитики также используют его, чтобы привести в порядок выгруженные данные перед вставкой в таблицу или ноутбук для дальнейшей работы.

Советы по работе с большим или неудобным JSON

Если документ не проходит валидацию, работайте сверху вниз: указанная позиция стоит сразу за местом обрыва, поэтому проверьте токен непосредственно перед ней — пропущенную запятую, незакрытую скобку или кавычку, которую так и не завершили. Для глубоко вложенных данных сначала отформатируйте, а затем используйте подсветку парных скобок в редакторе, чтобы убедиться, что у каждой открывающей скобки есть пара.

Когда нужна лишь часть огромной полезной нагрузки, вставьте всё целиком, отформатируйте, чтобы стала видна структура, а затем скопируйте только тот объект или массив, который вам нужен, и отформатируйте его отдельно. Отступ в два или в четыре пробела — чисто косметика; выбирайте тот, что совпадает с файлом, куда вы вставляете результат, чтобы diff-ы оставались чистыми.

Похожие инструменты на ConvertForever

Значения JSON часто путешествуют, завёрнутые в другие кодировки. Если поле содержит Base64-блок, декодируйте его инструментом Base64, чтобы увидеть исходный текст; если в нём процентно-кодированный URL, декодер URL вернёт его в читаемый вид. JWT, который вы нашли в ответе, — это три сегмента в Base64url, а его средний сегмент сам по себе является JSON, который можно вставить прямо сюда для форматирования.

Для проверки целостности генератор хешей вычисляет отпечаток SHA-256 для документа JSON, чтобы понять, идентичны ли две полезные нагрузки байт в байт. Каждый из этих инструментов работает на стороне клиента с тем же приоритетом приватности, поэтому вы можете перемещать данные между ними так, что ничего не покидает ваш браузер.

Часто задаваемые вопросы

Похожие инструменты