JSON

Что такое JSON?

JSON (JavaScript Object Notation) — это лёгкий текстовый формат обмена данными, удобный для чтения и записи людьми и простой в обработке для машин. Изначально производный от JavaScript, JSON не зависит от языка программирования и является де-факто стандартом обмена данными в интернете.

JSON представляет данные в виде пар «ключ-значение», организованных в объекты и массивы. Его простота сделала его доминирующим форматом для REST API, конфигурационных файлов и хранения данных.

Краткая история

JSON был формализован Дугласом Крокфордом в начале 2000-х годов. Спецификация была опубликована на json.org в 2001 году. RFC 4627 вышел в 2006 году, текущий стандарт ECMA-404 — в 2013 году.

До JSON XML был доминирующим форматом обмена данными. Минимализм JSON — без атрибутов, инструкций обработки и пространств имён — сделал его мгновенно популярным. К 2010 году JSON в значительной мере вытеснил XML в веб-API.

Типы данных JSON

JSON поддерживает ровно шесть типов данных. Каждое значение в корректном JSON-документе должно быть одним из них:

{
  "string":  "hello world",
  "number":  42,
  "float":   3.14,
  "boolean": true,
  "null":    null,
  "array":   [1, 2, 3],
  "object":  { "nested": "value" }
}

Правила синтаксиса JSON

JSON имеет строгие правила синтаксиса. Небольшое отклонение вызывает ошибку разбора. Вот шесть самых важных правил:

Недопустимый и допустимый JSON

{
  'name': 'Alice',       // single quotes — invalid
  age: 30,              // unquoted key — invalid
  "scores": [1, 2, 3,], // trailing comma — invalid
  "note": undefined     // undefined — invalid
}

{
  "name": "Alice",
  "age": 30,
  "scores": [1, 2, 3],
  "note": null
}

JSON в современном вебе

REST API

JSON является стандартным форматом тела для запросов и ответов REST API. Практически каждый язык программирования имеет встроенный парсер JSON.

Конфигурационные файлы

package.json, tsconfig.json, .eslintrc и многие другие инструменты разработчика используют JSON для конфигурации.

NoSQL-базы данных

Документоориентированные базы данных, такие как MongoDB, CouchDB и Amazon DynamoDB, хранят данные в виде JSON-документов.

Состояние и данные фронтенда

localStorage и sessionStorage хранят строки, поэтому JSON.stringify/JSON.parse постоянно используются для сериализации объектов JavaScript.

JSON в сравнении с другими форматами

JSON не всегда лучший выбор. Вот как он сравнивается с другими распространёнными форматами данных:

JSON Schema

JSON Schema — это словарь для проверки структуры JSON-документов. Схема описывает ожидаемые типы, обязательные поля и ограничения JSON-значения.

Такие инструменты, как ajv (JavaScript), jsonschema (Python) и встроенные валидаторы во многих IDE, поддерживают JSON Schema. OpenAPI использует JSON Schema для описания тел запросов и ответов API.

Распространённые проблемы JSON

Часто задаваемые вопросы