JSON: форматирование и валидатор

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

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

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

API и веб-сервисы обычно отдают JSON одной длинной «минифицированной» строкой без пробелов и переносов, чтобы он был компактнее. Форматирование JSON (его же называют JSON formatter или pretty printer) превращает эту строку в дерево вложенных уровней с отступами, которое удобно читать человеку. Кнопка «Минифицировать» делает обратное и убирает все пробельные символы.

• Меняются только пробельные символы. Многие инструменты читают JSON и записывают его заново, а это меняет данные: длинные числа вроде 12345678901234567890 теряют цифры, 1.0 становится 1, кириллица превращается в П..., а ключи меняют порядок. Этот инструмент копирует каждое число, строку и ключ так, как вы их записали, и лишь добавляет или убирает пробелы и переводы строк.
• Открыть файл (или перетащить файл в поле) читает файл .json с вашего компьютера; Скачать сохраняет результат, например config.min.json после минификации.
• Отступ в 2 пробела, 4 пробела или табуляция. Сортировка ключей упорядочивает ключи каждого объекта по алфавиту; по умолчанию сохраняется ваш порядок.
• Инструмент рассчитан на текст ответов API, конфигурации и файлы данных. Сама проверка быстрая (файл на 12 МБ читается за доли секунды), но текстовое поле с множеством мегабайт отрисовывается медленно: до 1–2 МБ работает мгновенно, около 8 МБ результата занимает несколько секунд.

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

Текст разбирает сам инструмент по стандарту JSON (RFC 8259), поэтому сообщение одинаково в любом браузере. Он показывает строку и столбец, саму строку с указателем под ошибкой и подсказку. Кнопка «Перейти к ошибке» выделяет это место в тексте. Самые частые ошибки, которые он распознаёт:

• запятая после последнего элемента или свойства (лишняя запятая) либо пропущенная запятая между двумя элементами;
• одинарные кавычки вместо двойных и имена свойств без кавычек;
• комментарии (//, /* */, #), которых в JSON нет;
• пропущенные или лишние скобки с указанием места, где была открыта незакрытая скобка;
• значения из других языков: True, None, undefined, NaN, Infinity;
• недопустимые числа: 01, .5, +1, 1., 0x1F;
• перевод строки внутри строки, неизвестная escape-последовательность вроде \x и символы, которые лишь выглядят правильно: типографские кавычки, неразрывный пробел, пробел нулевой ширины.

Ключ, который встречается в одном объекте дважды, допустим в JSON, но почти всегда это ошибка, поэтому инструмент выводит такие ключи как предупреждение. Метка порядка байтов в начале текста игнорируется.

Строгий JSON, а не JSON5 или JSONC

Валидатор принимает ровно то, что разрешает JSON. Комментарии, лишние запятые и одинарные кавычки — ошибки, даже если некоторые программы их терпят. Например, tsconfig.json — это JSONC, где комментарии и лишние запятые разрешены, поэтому валидатор на них сообщает. Файл JavaScript вроде astro.config.mjs или vite.config.js — это код, а не JSON, и проверить его здесь нельзя; package.json — это JSON, и его можно.

JSON, XML и CSV коротко

• JSON: вложенные объекты и списки с типами «строка», «число», true/false и null. Обычный формат веб-API и конфигурации. Ни комментариев, ни атрибутов.
• XML: вложенные теги с атрибутами и пространствами имён, проверяемые схемами XSD; более многословный, распространён в старых системах, SOAP и документах.
• CSV: плоская таблица текста со строкой заголовка; без типов и вложенности, зато открывается в электронной таблице.

Эта страница работает только с JSON и не конвертирует между этими форматами. Чтобы проверить, что у документа JSON правильная структура (обязательные поля, типы, допустимые значения), воспользуйтесь валидатором JSON Schema.

Ограничения

• Вложенность глубже 2000 уровней считается ошибкой.
• Весь текст хранится в памяти браузера и показывается в текстовом поле, поэтому очень большие файлы (больше 10 МБ) работают медленно, особенно на телефоне.
• Показывается только первая синтаксическая ошибка: исправьте её, и следующая, если она есть, сразу появится.
• Результат доступен только для корректного JSON: при ошибке правое поле остаётся пустым, а слева показано, что исправить.