Что такое форматирование JSON?
JSON (JavaScript Object Notation) — это лёгкий текстовый формат обмена данными, определённый в RFC 8259 и ECMA-404. Документ JSON — это дерево из шести типов значений: object, array, string, number, boolean и null. Форматирование добавляет пробелы, чтобы человеку было удобно читать это дерево; минификация удаляет пробелы, чтобы машины могли быстрее передавать его по сети.
Как работает форматирование JSON?
Ваш ввод полностью обрабатывается в браузере с помощью встроенных функций JSON.parse и JSON.stringify. Основные шаги:
- Ввод считывается из текстового поля, и пробелы в начале и конце удаляются.
- Браузер разбирает его с помощью
JSON.parse. Если ввод не является корректным JSON, парсер выбрасываетSyntaxError, который перехватывается и отображается с указанием строки и столбца, где он остановился. - Когда ввод корректен, разобранное значение снова сериализуется с помощью
JSON.stringify(value, null, indent), гдеindent— выбранный вами отступ (2 пробела, 4 пробела или символ табуляции). - Для минификации
JSON.stringify(value)вызывается без аргумента отступа, что даёт самую короткую корректную форму того же значения без незначащих пробелов. - Результат записывается в текстовое поле только для чтения, а панель состояния сообщает либо Корректный JSON, либо точную ошибку разбора, чтобы вы могли исправить источник.
Зачем форматировать JSON этим инструментом?
- Конфиденциальность: каждый этап разбора, форматирования и минификации происходит в вашем браузере. JSON никогда не попадает на наши серверы.
- Мгновенная проверка: неправильно поставленные запятые, ключи без кавычек, одинарные кавычки и завершающие запятые сообщаются с точным указанием строки и столбца, чтобы вы могли сразу перейти к ошибке.
- Готовый к ревью вывод: красиво напечатанный JSON с одинаковыми отступами даёт чистые диффы в код-ревью и читаемые файлы конфигурации.
- Готовая к продакшену минификация: удаление незначащих пробелов уменьшает размер API-ответов, файлов манифеста и встроенных фикстур перед публикацией.
Каковы распространённые применения форматирования JSON?
Чтение и запись JSON встречаются во всём веб-разработке и инструментарии:
- Отладка API: вставка сырого ответа из
curlили панели сети, чтобы подтвердить структуру, найти опечатку в ключе или заметить пропущенную закрывающую скобку. - Чистка конфигов: повторное форматирование вручную правленных
package.json,tsconfig.jsonили CI-манифестов, чтобы они проходили ревью и линтеры. - Чтение логов: переформатирование компактных строк
application/json, чтобы каждое поле выровнялось друг под другом, а затем минификация перед вставкой в тикет.
Как выглядит пример форматирования JSON?
Если вставить {"id":42,"name":"Ada Lovelace","email":"ada@example.com","roles":["admin","engineer"]} и нажать ФОРМАТИРОВАТЬ с отступом в 2 пробела, текст развернётся на девять строк: каждое поле объекта и каждый элемент массива окажутся на отдельной строке. Нажатие МИНИФИЦИРОВАТЬ на отформатированном тексте побайтно сворачивает его обратно в ту же компактную строку.
Этот форматировщик JSON разбирает данные тем же движком, который использует ваш Node.js, Deno или браузер, и выдаёт результат, который можно вставлять прямо в код, конфигурации или логи.