Найдите ошибку до загрузки в приложение
Вы получили ответ API одной строкой или открыли файл настроек, где трудно увидеть границы объектов. Для такой задачи удобен JSON-редактор: он проверит синтаксис, расставит отступы и позволит скачать читаемый документ. Если нужна компактная запись, можно убрать пробелы вне строк.
Инструмент работает с настоящим JSON. JavaScript-объекты с комментариями, одинарными кавычками и запятой после последнего элемента сюда не подходят. Синтаксическая проверка помогает найти повреждённую запись, но не определяет, верны ли цены, статусы заказов или названия полей для конкретного API.
Как проверить или отформатировать JSON
- Вставьте документ в поле или выберите файл .json в кодировке UTF-8. Допустимый размер входных данных составляет 1 МБ.
- Выберите режим. «Форматировать» добавит отступы, «Убрать лишние пробелы» создаст компактную запись, «Проверить синтаксис» сохранит исходную структуру пробелов внутри документа.
- Для форматирования выберите два пробела, четыре пробела или табуляцию. Нажмите «Обработать JSON».
- Изучите результат и замечания. Скопируйте текст либо скачайте файл, затем проверяйте его по требованиям приложения, куда он будет загружен.
Числа и строки сохраняют исходную запись
В JSON иногда встречаются длинные идентификаторы, например 9007199254740993. Если прочитать такое число обычным Number JavaScript и записать заново, оно может потерять точность. Этот форматтер сохраняет исходные числовые токены и не подменяет их округлённым значением.
Порядок ключей, запись 1e3 или 1.00, экранирование символов внутри строк тоже сохраняются. Меняются только разделительные пробелы в зависимости от выбранного режима. Даже если число выходит за безопасный диапазон JavaScript, в результате остаётся исходная запись, а инструмент выводит замечание для дальнейшей проверки.
Что делать с повторяющимися ключами
В одном объекте могут оказаться два поля с одинаковым именем. Например, price сначала указан как 1200, затем как 1500. Такие документы по-разному обрабатываются программами: одно из значений может потеряться. Форматтер отмечает повтор и сохраняет обе записи, чтобы решение принял разработчик.
Не удаляйте дубликат наугад. Сверьте документ с источником данных, выясните, какое значение должно использоваться, и исправьте генератор JSON. Иначе при следующей выгрузке повтор появится снова. Ключи в разных объектах не считаются дубликатами друг друга.
Сжатие JSON не меняет бизнес-данные
Минификация удаляет пробелы и переносы между элементами. Пробел внутри названия товара, адреса или текста сообщения остаётся частью строки. Компактная запись бывает удобна для передачи, но при поиске ошибок читаемый вариант обычно полезнее.
Не используйте минификацию как способ исправления невалидного документа. Если JSON не разобран, готовый файл не создаётся. Сначала исправьте кавычки, скобки и другие указанные ошибки, затем повторите обработку. Файл с BOM в начале принимается: этот служебный маркер удаляется перед проверкой.
Границы проверки и работа с файлами
Обработка выполняется в браузере. Документ не отправляется на сервер QuickLanding и не записывается в CMS. Скачанный файл создаётся из результата, а исходник остаётся прежним. Для очень крупных выгрузок лучше использовать локальный редактор или обработку потоками.
Здесь ограничены размер до 1 МБ, вложенность до 64 уровней и количество элементов синтаксиса до 100000. JSON Schema, обязательные поля API, корректность ссылок и значения справочников отдельно не проверяются. Для структурированных данных страницы есть другой инструмент: конструктор JSON-LD.
Следующий шаг и полезные материалы
Вопросы об инструменте
Будут ли большие числа округлены?
Нет. Запись чисел сохраняется из исходного текста. Числа вне безопасного диапазона JavaScript отмечаются, чтобы проверить их обработку в вашем приложении.
Можно вставлять комментарии?
Нет. Обычный JSON не допускает комментарии, одинарные кавычки и запятые после последнего элемента.
Повторяющиеся ключи удаляются?
Нет. Повторы отмечаются, но все записи сохраняются. Исправляйте их после проверки источника данных.
Это проверка JSON Schema?
Нет. Инструмент проверяет синтаксис JSON. Для проверки обязательных полей и типов по схеме нужен отдельный валидатор.
