Проверить JSON

Что на самом деле запрещает JSON

Грамматика JSON намеренно крошечная, и почти любая ошибка проверки — одна из немногих вещей, которые люди заимствуют из JavaScript, но которых в JSON никогда не было. Висячая запятая после последнего элемента. Одинарные кавычки вместо двойных. Ключи без кавычек. Комментарии — в JSON их нет и никогда не было. NaN и Infinity — допустимые числа в JavaScript, но недопустимые в JSON. И метка порядка байтов в начале файла — невидимая в любом редакторе, её добавляют некоторые программы Windows при сохранении в UTF-8, и из-за неё вполне корректный документ падает на первом же символе.

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

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

Синтаксически корректный — не то же самое, что правильный, и это различие важно. Здесь подтверждается, что синтаксис разбирается. Есть ли в документе поля, которых требует ваш API, в допустимом ли диапазоне значение, действительно ли дата — это дата, — ничто из этого не вопрос JSON. Это проверка по схеме, для неё нужна схема, и документ может быть безупречным здесь и сразу же отвергнут сервисом, которому вы его отправляете.

Если нужно другое

Для проверки документов по схеме, а не по грамматике, стандарт — JSON Schema, а самая быстрая его реализация — ajv: он скажет, что обязательного поля нет или значение вне диапазона, — а обычно вас интересует именно это. check-jsonschema выполняет те же проверки из командной строки и в CI.

Для командной строки нужен jq: jq empty file.json проверяет файл и при успехе ничего не выводит — ровно то, что нужно скрипту, а jq . форматирует. Для файлов, слишком больших для памяти, jq --stream и ijson для Python разбирают документ по частям, чего не может ни одна страница, загружающая документ целиком.