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

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

Разработка 5 мин. чтения

Если вы работали с API, файлом настроек или выгрузкой данных, вы встречали JSON. Он выглядит простым, но одной лишней запятой достаточно, чтобы весь файл стал недействительным, а сообщение об ошибке оказалось малопонятным.

В этом руководстве вы узнаете, что такое JSON, какие типы значений он поддерживает, какие правила синтаксиса нужно помнить, разберёте частые ошибки на примерах «до и после» и научитесь за секунды проверять, форматировать и сжимать данные.

Проверьте и отформатируйте JSON прямо сейчас Вставьте JSON, чтобы найти ошибки, отформатировать или сжать его. Всё работает в вашем браузере, ничего не загружается. Открыть форматировщик JSON

Что такое JSON?

JSON (JavaScript Object Notation) — это лёгкий текстовый формат для хранения и обмена данными. Данные организованы в пары «ключ и значение», например {"name": "Ana", "age": 30}. Его легко читать человеку и легко разбирать программе.

Хотя JSON появился в JavaScript, он не привязан к языку. Это стандартный способ передачи данных между серверами и приложениями в веб-API, а также популярный формат для файлов настроек, логов и экспорта.

Шесть типов значений

Любое значение в JSON относится к одному из шести типов:

  • Строка (string): текст в двойных кавычках, например "привет".
  • Число: целое или дробное, например 42 или 3.14, без кавычек.
  • Логическое значение: true или false, строчными буквами и без кавычек.
  • Null: слово null, означающее «нет значения».
  • Массив (array): упорядоченный список в квадратных скобках, например [1, 2, 3].
  • Объект: набор пар «ключ и значение» в фигурных скобках, например {"city": "Kazan"}. Ключи всегда строки.

Массивы и объекты могут содержать другие массивы и объекты, поэтому можно описать данные любой вложенности.

Правила синтаксиса, которые нужно помнить

JSON намного строже, чем JavaScript. Большинство ошибок возникает из-за нарушения одного из этих правил:

  • Строки и ключи берутся в двойные кавычки. Одинарные кавычки не допускаются.
  • Никаких лишних запятых: после последнего элемента массива или объекта запятой быть не должно.
  • Никаких комментариев: ни // ни /* */ недопустимы.
  • Есть только шесть типов: undefined, NaN, Infinity и функции недопустимы.
  • Пары разделяются запятыми, а ключ от значения отделяется двоеточием.
  • У каждой открытой скобки должна быть закрывающая.

Самые частые ошибки и как их исправить

Эти пять промахов вызывают подавляющее большинство сообщений «невалидный JSON»:

  • Лишняя запятая. Было: {"a": 1, "b": 2,}. Стало: {"a": 1, "b": 2}. Уберите запятую после последнего элемента.
  • Одинарные кавычки. Было: {'name': 'Ana'}. Стало: {"name": "Ana"}. Замените все одинарные кавычки на двойные.
  • Ключ без кавычек. Было: {name: "Ana"}. Стало: {"name": "Ana"}. Заключайте каждый ключ в двойные кавычки.
  • Не хватает скобки. Было: {"items": [1, 2, 3}. Стало: {"items": [1, 2, 3]}. Закрывайте каждый открытый массив и объект.
  • Неверное экранирование кавычек. Было: {"text": "Он сказал "привет""}. Стало: {"text": "Он сказал \"привет\""}. Двойную кавычку внутри строки нужно экранировать обратной косой чертой. То же относится и к самой обратной косой черте, которая пишется как \\.

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

Как читать сообщение об ошибке JSON

Большинство парсеров сообщают, где они запутались, например "Unexpected token } in JSON at position 25" или "Expected double-quoted property name at line 3 column 5". Позиция — это число символов от начала, а строка и столбец указывают точное место.

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

Как проверить, отформатировать и сжать JSON

  1. Откройте бесплатный форматировщик JSON. Он работает целиком в вашем браузере, поэтому данные не покидают устройство.
  2. Вставьте свой JSON. Если он неверный, инструмент покажет ошибку со строкой и столбцом, чтобы вы могли её исправить.
  3. Используйте форматирование, чтобы добавить отступы и сделать текст читаемым, или сжатие, чтобы убрать пробелы и уменьшить размер перед отправкой.
  4. Скопируйте результат. Если вы изменили файл и хотите точно увидеть отличия, сравните две версии с помощью инструмента сравнения текста.

JSON, XML и YAML

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

JSON находится посередине: компактный, однозначный и поддерживаемый практически всеми языками, поэтому он стал выбором по умолчанию для API. Главный недостаток — отсутствие комментариев.

Практические советы

  • Всегда проверяйте JSON перед отправкой или сохранением в файл настроек.
  • Используйте редактор с подсветкой JSON: он сразу показывает непарные кавычки и скобки.
  • Не пишите JSON вручную, если его можно сформировать кодом: библиотеки правильно экранируют символы.
  • Если параметр URL содержит JSON, сначала закодируйте его кодировщиком URL, чтобы специальные символы не сломали запрос.
  • Не вставляйте пароли и токены в онлайн-инструменты, которые загружают данные на сервер. Выбирайте те, что работают локально.

Вывод

JSON прост, когда знаешь правила: шесть типов значений, двойные кавычки, никаких лишних запятых и комментариев. Если что-то сломалось, прочитайте строку и столбец ошибки, проверьте место сразу перед ним и доверьте основную работу валидатору. Несколько секунд с форматировщиком экономят много времени на отладке.

Частые вопросы

Для чего нужен JSON?

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

Можно ли использовать комментарии в JSON?

Нет. Стандартный JSON не допускает комментариев. Если нужны заметки, добавьте обычное поле, например "comment", или используйте для настроек формат вроде YAML.

Почему мой JSON выдаёт "unexpected token"?

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

Чем отличается форматирование от сжатия JSON?

Форматирование добавляет переносы строк и отступы для удобства чтения. Сжатие убирает все лишние пробелы, чтобы уменьшить размер файла. Сами данные остаются точно такими же.

Безопасно ли пользоваться онлайн-форматировщиком JSON?

Безопасно, если инструмент работает в браузере и не отправляет содержимое на сервер. Наш форматировщик JSON обрабатывает всё локально на вашем устройстве.

Бесплатные инструменты из этой статьи

Читайте также

Все статьи