Что такое JSON? Как проверить и устранить распространенные ошибки

От структуры данных до стратегии проверки: создавайте JSON, который можно читать, поддерживать и обмениваться.

Что такое JSON? Как проверить и устранить распространенные ошибки

Что такое JSON

JSON (нотация объектов JavaScript) — это текстовый формат, обычно используемый для обмена данными между файлами конфигурации, запросами API и системами. Его легко читать, но формат очень строгий: на одну запятую меньше или на одну кавычку больше — синтаксический анализ не удастся.

Основная структура

JSON состоит из объектов, массивов и базовых значений. Объекты заключаются в фигурные скобки, имена ключей должны заключаться в двойные кавычки; массивы заключаются в квадратные скобки. Действительный JSON может содержать строки, числа, логические значения, null, объекты и массивы.

{ "user": { "name": "Lin", "active": true }, "tags": ["api", "docs"] 

Наиболее распространенные ошибки проверки

  • Используйте одинарные кавычки или забудьте добавить двойные кавычки для имен ключей.
  • После последнего элемента стоит лишняя запятая.
  • В строке присутствуют неэкранированные символы новой строки или двойные кавычки.
  • Запишите неопределенный JavaScript, аннотации или функции в JSON.

Практическая последовательность устранения неполадок

Сначала позвольте форматтеру/валидатору найти строку ошибки, а затем проверьте парную структуру от внешней фигурной скобки или квадратной скобки внутрь. Убедившись, что формат действителен, проверьте имена полей, типы и бизнес-правила; эти три вещи не следует смешивать вместе.

Заключение

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