Сборка падает с ошибкой «Unexpected token in JSON at position 4,821». Отлично, спасибо. Теперь вам предстоит пролистать четырёхтысячесимвольный конфиг-файл, считая скобки в уме, пытаясь понять, какая из них не закрыта. Это одна из самых легко предотвратимых потерь времени в разработке ПО, и происходит она постоянно, потому что JSON не прощает мелких ошибок.
Висячая запятая после последнего элемента массива. Пропущенная кавычка вокруг ключа. Лишняя закрывающая скобка, скопированная откуда-то ещё. Любая из них полностью ломает парсинг, а сообщение об ошибке редко указывает на реальную проблему — оно указывает туда, где парсер сдался, а это часто далеко от настоящей ошибки.
Почему номера позиций не помогают
Большинство парсеров JSON сообщают об ошибках как смещение символа, а не как строку и столбец, к которым можно перейти в редакторе. Чтобы превратить позицию 4821 в «строку 112, где-то рядом с третьим объектом», нужно либо считать вручную, либо писать одноразовый скрипт. Ни то, ни другое не лучший способ провести день.
Некоторые редакторы подсвечивают синтаксические ошибки JSON прямо в тексте, что помогает для файлов, которые вы активно пишете. Но для JSON, полученного от API, коллеги или унаследованного легаси-конфига, нужен инструмент, который берёт исходный текст и точно говорит, что и где не так.
Проверяйте JSON, не покидая свой Mac
Форматтер JSON, который одновременно проверяет корректность, убирает необходимость угадывать. Вставьте JSON — и если он некорректен, вы получите чёткую ошибку с указанием конкретной строки и символа вместо сырого смещения байтов. Если он корректен, он аккуратно отрисуется с правильными отступами, чтобы вы могли визуально просмотреть структуру. Bellows обрабатывает оба случая в одном инструменте — вам не нужно заранее знать, сломан ли ваш JSON.
Отлов ошибок до релиза
Конфиг-файлы, тела запросов API и тестовые данные живут и умирают в зависимости от корректности JSON. Быстрая проверка перед коммитом изменения конфига или отправкой тестового запроса отлавливает опечатки, которые иначе всплыли бы в виде запутанной ошибки времени выполнения гораздо позже в пайплайне.
Работа с недоверенными данными
Когда коллега вставляет вам блок JSON в Slack или вы забираете его из стороннего API, которому не полностью доверяете, локальная проверка означает, что вам никогда не придётся отправлять эти данные на внешний сайт только для того, чтобы проверить, парсится ли он.