Разработка 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
- Откройте бесплатный форматировщик JSON. Он работает целиком в вашем браузере, поэтому данные не покидают устройство.
- Вставьте свой JSON. Если он неверный, инструмент покажет ошибку со строкой и столбцом, чтобы вы могли её исправить.
- Используйте форматирование, чтобы добавить отступы и сделать текст читаемым, или сжатие, чтобы убрать пробелы и уменьшить размер перед отправкой.
- Скопируйте результат. Если вы изменили файл и хотите точно увидеть отличия, сравните две версии с помощью инструмента сравнения текста.
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 обрабатывает всё локально на вашем устройстве.
Бесплатные инструменты из этой статьи
Читайте также
- Как создать надёжный парольДлина, случайность и уникальность: простые правила, которые действительно защищают ваши аккаунты, и как их соблюдать, ничего не запоминая.
- Техника Помодоро: полное руководствоРаботайте блоками по 25 минут с короткими перерывами. Как устроен метод, как начать сегодня и как подстроить его под свой режим.
- Что такое хеш? MD5, SHA-256 и для чего они нужныХеш — это короткий отпечаток любых данных. Как он работает, каким алгоритмам доверять и как с его помощью проверять файлы и защищать пароли.