JSON: что это за формат и как открыть файл

Короткий ответ

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

Сайты и приложения используют JSON, чтобы обмениваться данными: браузер получает от сервера список товаров, программа сохраняет настройки, сервис выгружает архив ваших данных. Название расшифровывается как JavaScript Object Notation: запись заимствована у языка JavaScript, но сам формат не зависит от языка программирования и читается практически любой современной программой.

Как выглядит JSON

Так может выглядеть запись о покупателе:

{
  "name": "Анна",
  "age": 28,
  "subscribed": true,
  "phone": null,
  "cities": ["Москва", "Казань"],
  "address": {
    "city": "Москва",
    "zip": "101000"
  }
}

Слева от двоеточия стоит название поля — ключ, справа — его значение. Пары разделены запятыми. Значения бывают шести видов:

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

Где встречаются JSON-файлы

• Выгрузка данных. Сервисы часто отдают архив переписки, контактов или истории заказов в JSON, потому что формат сохраняет структуру данных.
• Настройки программ и игр. Файлы вроде config.json и settings.json хранят параметры, которые программа читает при запуске.
• Сайты и веб-приложения. Браузер и сервер обмениваются данными через API, а описание веб-приложения хранится в файле манифеста.
• Сообщения об ошибках. Надпись JSON parse error на сайте означает, что данные не удалось прочитать. О ней — ниже.

Чем открыть JSON-файл

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

Почему JSON записан в одну длинную строку

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

Вернуть отступы можно форматированием JSON: вставьте текст, нажмите «Форматировать» и выберите отступ в два или четыре пробела либо табуляцию. Кнопка «Минифицировать» выполняет обратную операцию — минификацию.

Что значит JSON parse error

Parse — это разбор текста. Ошибка означает, что программа попыталась прочитать текст как JSON и встретила то, чего по правилам формата быть не может. В англоязычных сообщениях это выглядит как JSON.parse: unexpected character или unexpected end of data. Что делать, зависит от того, где появилась ошибка.

Частые ошибки в JSON

С комментариями есть исключение. Некоторые программы используют расширенный вариант формата: например, файлы настроек Visual Studio Code открываются в режиме JSON with Comments, где комментарии разрешены. Стандартный JSON их не допускает, и строгая проверка покажет ошибку.

JSON и XML

XML — ещё один текстовый формат для данных. Вместо скобок и кавычек в нём используются теги: <city>Москва</city>. Та же информация в JSON обычно короче и проще читается, поэтому JSON чаще встречается в веб-сервисах. XML остаётся в документах и системах, которые исторически на нём построены. Выбирать между ними пользователю обычно не приходится: формат определяет программа, которая читает файл.

Коротко

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