Как отформатировать JSON с отступами и проверить его на ошибки

Для чего форматировать JSON

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

Для представления доступны три настройки: величина отступа, сортировка ключей и компактный вывод. Если не менять параметры, используются два пробела, сортировка ключей остаётся выключенной, а компактный режим не включается. При корректном JSON символы Unicode, включая кириллицу, могут сохраниться в итоговом тексте без обязательной замены на escape-последовательности. Это помогает читать русские значения непосредственно в результате.

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

Пошаговая обработка текста

Подготовьте текст JSON и вставьте его в поле ввода. Подходят синтаксически корректные JSON-значения, например объект, массив, строка, число, логическое значение или null. Поле необязательно: если оставить его пустым либо ввести только пробелы, операция завершится успешно, сообщит об отсутствии JSON и не создаст форматированное содержимое.
Укажите величину отступа для многострочного представления. Значение по умолчанию равно двум пробелам. Выберите большее расстояние, если вложенные уровни трудно различать, или меньшее, если нужен более плотный вид. Эта настройка меняет оформление текста, а не добавляет поля в объект.
При необходимости включите сортировку ключей. В исходном состоянии функция отключена. После включения ключи объектов упорядочиваются в форматированном выводе, поэтому такой вариант может облегчить визуальное сравнение похожих структур. Помните, что изменяется порядок представления ключей, а не набор данных.
Включите компактный вывод, когда переносы строк и отступы не нужны. При этом сериализованный JSON получает компактные разделители запятой и двоеточия вместо оформления с отступами. Для ручного чтения вложенных объектов обычно удобнее оставить обычный многострочный вид.
Запустите обработку и прочитайте сформированный результат. Если разбор прошёл успешно, появится JSON, оформленный с выбранными параметрами. Если обнаружена ошибка разбора, изучите подробности, исправьте соответствующий фрагмент и повторите действие. При таком сбое возвращённым содержимым остаётся отправленный текст, поэтому его нельзя принимать за исправленный результат.
Перед дальнейшим использованием сравните результат с исходной записью. Особое внимание уделите кавычкам, запятым, двоеточиям и закрывающим скобкам в месте, указанном в подробностях ошибки. При включённой сортировке проверьте порядок ключей, а в строках с кириллицей убедитесь, что Unicode-символы отображаются ожидаемым образом.

Что означает полученный результат

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

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

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

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

Практический пример

Для проверки небольшого объекта с именем и массивом выберите читаемое форматирование перед использованием текста в приложении.

Вставьте JSON {"имя":"Анна","items":[1,2]}, задайте отступ в четыре пробела, включите сортировку ключей и запустите обработку. Ожидаемая форма результата содержит отдельные уровни вложенности и упорядоченные ключи объекта, без заявления о конкретном выполненном выводе здесь оформлена только форма результата.

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

Ограничения

Проверяется разбираемость текста как JSON, но не соответствие схеме, обязательным полям или правилам отдельного API.

Частые ошибки

После сбоя разбора отправленный текст принимают за готовый результат. Исправьте синтаксис по подробностям ошибки и запустите обработку повторно: при неудаче исходная запись возвращается без исправления.

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

Что произойдёт, если не вставить JSON?

Если поле оставить пустым или ввести только пробелы, операция завершится успешно, укажет на отсутствие JSON и не создаст форматированный текст. Для проверки результата вставьте непустую JSON-запись и запустите обработку снова.

Можно ли отсортировать ключи JSON?

При включённой настройке ключи объектов упорядочиваются в форматированном выводе. По умолчанию сортировка отключена, поэтому порядок без изменения параметра зависит от исходной записи и выбранного оформления.

Проверяет ли инструмент JSON по схеме?

Результат показывает, что текст удалось разобрать как JSON, но не подтверждает соответствие схеме, обязательным полям или правилам отдельного API. Для такой проверки потребуются дополнительные правила.