Форматирование и проверка JSON

Что делает этот инструмент

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

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

Как пользоваться

Вставьте или введите JSON в поле ввода. Форматирование запускается автоматически по мере набора. Выберите отступ в 2 пробела, 4 пробела или табуляцию и при желании включите сортировку ключей, чтобы упорядочить ключи объектов по алфавиту на каждом уровне вложенности, — так два документа удобно сравнивать инструментом различий. Нажмите «Сжать», чтобы убрать все пробелы, когда нужна минимальная полезная нагрузка для HTTP-запроса или переменной окружения. Кнопка «Копировать» кладёт результат в буфер обмена, «Скачать» сохраняет его файлом .json.

Строка состояния показывает размер в байтах, число ключей объектов и максимальную глубину вложенности — быстрый способ проверить крупный документ на вменяемость, прежде чем куда-то его отправлять.

Какие ошибки ловит валидатор

Запятая после последнего элемента массива или объекта в JSON недопустима, хотя большинство языков программирования её принимают. Одинарные кавычки вокруг строк или ключей неверны: JSON требует двойных. Комментариев в спецификации JSON нет, поэтому блок // или /* */ вызовет ошибку. Ключи без кавычек вроде {name: "x"} — это литерал объекта JavaScript, а не JSON. Особых значений NaN, Infinity и undefined в JSON не существует. Каждый такой случай даёт понятную ошибку с позицией, к которой можно сразу перейти.

История: откуда взялся JSON

Формат JSON (JavaScript Object Notation) описал Дуглас Крокфорд в начале 2000-х как лёгкую альтернативу XML, взяв синтаксис литералов объектов, который уже был в JavaScript. Он был стандартизирован как RFC 4627 в 2006 году, а затем как ECMA-404 и RFC 8259 (2017) — это и есть действующее определение: шесть типов значений (объект, массив, строка, число, true/false, null), UTF-8 как кодировка обмена и никаких комментариев. Его взлёт совпал с расцветом приложений, работающих в браузере: формат, который браузер разбирает сам через JSON.parse, обошёл всё, что требовало отдельного разборщика.

Где это нужно

Почти каждый веб-API отвечает в JSON — поэтому первое, что делают с незнакомым ответом, это вставляют его в форматировщик, чтобы увидеть структуру. Конфигурационные файлы (package.json, tsconfig.json, настройки VS Code), описания инфраструктуры (CloudFormation, состояние Terraform), документы NoSQL (MongoDB, колонки jsonb в PostgreSQL), конвейеры журналов (по одному объекту JSON на строку в ndjson) и полезная нагрузка токена JWT — всё это JSON; ещё он ездит внутри параметров URL, где его сначала нужно закодировать процентами. Родственные форматы его расширяют: JSON5 и JSONC добавляют комментарии и висящие запятые для конфигураций, JSON Schema описывает ожидаемую структуру, а JSON Lines передаёт множество документов одним файлом — и всё это здешний валидатор отвергнет как строгий JSON, что и задумано.

Частые вопросы