Форматтер JSON, который объясняет, что не так
Этот бесплатный форматтер JSON превращает стену минифицированных данных в читаемый JSON с отступами и одновременно проверяет его. Вставьте ответ API, файл конфигурации или строку журнала и получите сразу три инструмента: валидатор JSON, который указывает точные строку и столбец первой ошибки, форматтер JSON с отступами в 2 пробела, 4 пробела или табуляцию, а также минификатор, когда нужно вернуть компактную версию. Представление в виде дерева, сортировка ключей, валидация по JSON Schema и преобразование JSON в CSV доступны в один клик.
Всё выполняется в вашем браузере. Инструмент использует собственный небольшой парсер вместо отправки данных на сервер, поэтому он может объяснять ошибки простыми словами, а конфиденциальные данные, такие как токены, записи клиентов или внутренние конфигурации, никогда не покидают ваше устройство.
Как читать сообщение об ошибке JSON
Большинство ошибок JSON возникают не там, где парсер останавливается, а непосредственно перед этим. Когда валидатор сообщает Строка 3, столбец 9: Завершающая запятая перед "}", он показывает строку с указателем под проблемным символом, чтобы вы могли увидеть запятую, которой там быть не должно. Большинство реальных случаев охватывают несколько шаблонов:
-
Завершающая запятая. JavaScript допускает
[1, 2,], а JSON — нет. Удалите последнюю запятую. -
Одинарные кавычки или ключи без кавычек.
{name: 'Ann'}— это объект JavaScript, а не JSON. Ключи и строки должны быть заключены в двойные кавычки:{"name": "Ann"}. -
Комментарии. В JSON нет комментариев. Файлы, такие как tsconfig.json, принимают их, потому что их инструменты используют менее строгий формат, но строгий парсер JSON отклоняет
//и/* */. -
Пропущенная запятая или скобка. Если ошибка появляется в начале свойства, проверьте конец строки выше. Если ошибка — «неожиданный конец ввода», где-то пропущена закрывающая
}или]. -
Значения Python или JavaScript.
True,None,NaNиundefinedне являются JSON. Используйтеtrue,nullили число. -
Типографские кавычки. Текст, скопированный из текстового редактора или приложения для чата, часто содержит типографские кавычки, которые почти не отличаются от
".
Кнопка «Исправить распространённые ошибки» за один проход исправляет комментарии, одинарные кавычки, ключи без кавычек, завершающие запятые, типографские кавычки и значения в стиле Python, а также перечисляет внесённые изменения, чтобы вы могли проверить результат, а не слепо ему доверять.
Большие числа и повторяющиеся ключи
В самом JSON нет ограничения на размер чисел, но JavaScript хранит их как 64-битные числа с плавающей запятой. Такой идентификатор, как 12345678901234567890 становится 12345678901234567000 после обычного JSON.parse. Этот форматтер сохраняет каждое число в точности так, как вы его записали, и предупреждает, если значение превышает 2^53: это признак того, что его следует передавать как строку. Он также выявляет повторяющиеся ключи: стандарт JSON их не запрещает, но большинство парсеров молча сохраняют только последний, что скрывает ошибки.
Проверка JSON Schema вкратце
Валидатор JSON проверяет синтаксис. JSON Schema проверяет смысл: какие поля обязательны, какого они типа и какие значения допустимы. Небольшая схема выглядит так:
{"type": "object", "required": ["id", "email"],
"properties": {"id": {"type": "integer", "minimum": 1},
"email": {"type": "string", "format": "email"}}}
Вкладка JSON Schema поддерживает основные возможности draft 2020-12: типы, enum и const, ограничения для чисел и строк, pattern, распространённые форматы (email, date, date-time, uri, uuid, ipv4, hostname), properties, required, additionalProperties, patternProperties, items и prefixItems, uniqueItems, contains, allOf, anyOf, oneOf, not, if/then/else и локальные $ref ссылается на $defs. В каждой ошибке указывается путь к экземпляру, например $.users[1].emailи путь к схеме, на котором произошла ошибка. Ключевые слова, которые инструмент не проверяет, например unevaluatedProperties, выводятся отдельно, а не молча игнорируются. Если у вас пока нет схемы, создайте первый вариант на основе примера документа и доработайте его вручную.
Написание схем для целого API - более масштабная задача. Если вам также нужны структурированные данные на веб-страницах, валидатор разметки Schema проверяет JSON-LD для поисковых систем; это другой вид схемы.
Преобразование JSON в CSV и обратно
Электронным таблицам нужны строки и столбцы. Конвертер принимает массив объектов, использует объединение всех ключей в качестве заголовка, преобразует вложенные объекты в столбцы с точечной.нотацией, а массивы сохраняет как текст JSON в одной ячейке. Значения, начинающиеся с =, + или @, получают начальный апостроф, чтобы таблица не выполнила их как формулы. В обратном направлении вставьте CSV со строкой заголовков: разделитель определяется автоматически, поля в кавычках с запятыми и переносами строк обрабатываются корректно, числа и true/false можно распознавать как соответствующие типы, а заголовки address.city снова преобразуются во вложенные объекты. Для написания запросов, создающих эти данные, попробуйте конструктор SQL-запросов или генератор формул Excel.
Советы по ежедневной работе с JSON
- Проверяйте JSON перед отладкой. Половина обращений «API не работает» связана с пропущенной запятой в теле запроса.
- Сортируйте ключи перед сравнением двух документов. Тогда инструменты сравнения будут показывать реальные изменения, а не переставленные поля.
- Минифицируйте данные для передачи, форматируйте для людей. Пробелы не имеют значения в JSON, поэтому обе версии содержат одни и те же данные.
- Не храните секреты в общедоступных форматтерах. Онлайн-инструменты, которые загружают ваши данные, создают риск для токенов и персональных данных; этот инструмент ничего не загружает.
Другие бесплатные инструменты для разработчиков и команд доступны на странице бесплатных AI-генераторов и инструментов, включая генератор тестовых случаев для кода, который использует ваш JSON.
Часто задаваемые вопросы
Бесплатен ли этот форматтер JSON и обеспечивает ли он конфиденциальность?
Да. Инструмент бесплатен, регистрация не нужна, ограничений нет. Форматирование, проверка и преобразование выполняются в браузере на обычном JavaScript, поэтому ваш JSON не загружается, не регистрируется и не хранится на сервере.
В чём разница между форматтером JSON и валидатором JSON?
Форматтер (или beautifier) добавляет отступы и переносы строк, чтобы JSON было легко читать. Валидатор проверяет, соответствует ли текст правилам JSON, и сообщает о первой ошибке. Этот инструмент делает и то и другое одновременно и указывает точные строку и столбец любой ошибки.
Почему мой JSON не проходит проверку из-за завершающей запятой или одинарных кавычек?
JSON строже JavaScript. В нём нельзя ставить запятую после последнего элемента, использовать строки в одинарных кавычках, ключи без кавычек или комментарии. Используйте кнопку «Исправить распространённые ошибки», чтобы автоматически устранить эти проблемы, а затем проверьте изменения.
Изменяет ли форматтер мои числа или порядок ключей?
Нет. Числа сохраняются в точности в исходном виде, даже идентификаторы, превышающие максимальное значение, которое может хранить JavaScript, а ключи сохраняют исходный порядок, если не включить сортировку ключей от А до Я.
Какая версия JSON Schema поддерживается?
Инструмент проверяет основную часть JSON Schema draft 2020-12, включая типы, обязательные поля, свойства, enum, ограничения для строк и чисел, форматы, items, prefixItems, allOf, anyOf, oneOf, not, if/then/else и локальный $ref. Ключевые слова, которые он не проверяет, перечисляются вместо того, чтобы молча игнорироваться.