JSON
JSON — текстовый формат обмена данными, на котором общаются браузер и сервер. В уроке: JSON.stringify и JSON.parse, форматирование, replacer и reviver, метод toJSON и типичные ловушки с undefined, функциями, Map и Date.
Что такое JSON
JSON похож на литерал объекта JavaScript, но строже: ключи только в двойных кавычках, строки только в двойных кавычках, без комментариев и «лишних» запятых. Допустимые значения: объекты, массивы, строки, числа, true, false, null.
stringify: объект в строку
const user = { name: "Анна", age: 30, tags: ["a", "b"], address: { city: "Минск" } };
const json = JSON.stringify(user);
console.log(json, typeof json);
console.log(JSON.stringify(user, null, 2));
{"name":"Анна","age":30,"tags":["a","b"],"address":{"city":"Минск"}} string
{
"name": "Анна",
"age": 30,
"tags": [
"a",
"b"
],
"address": {
"city": "Минск"
}
}
Третий аргумент — отступ (число пробелов или строка) для читаемого вывода. Второй аргумент, replacer, позволяет отфильтровать или преобразовать поля — массивом имён или функцией:
console.log(JSON.stringify(user, ["name", "age"]));
console.log(JSON.stringify(user, (key, value) => typeof value === "number" ? value * 2 : value));
{"name":"Анна","age":30}
{"name":"Анна","age":60,"tags":["a","b"],"address":{"city":"Минск"}}
parse: строка в объект
const back = JSON.parse(json);
console.log(back.address.city, back === user);
console.log(JSON.parse("[1,2,3]"), JSON.parse('"hi"'), JSON.parse("null"), JSON.parse("true"), JSON.parse("5"));
Минск false
[ 1, 2, 3 ] hi null true 5
Результат — новый объект. Невалидный JSON приводит к исключению SyntaxError, поэтому данные от пользователя и сети разбирайте в try/catch:
try {
JSON.parse("{'a': 1}"); // одинарные кавычки — не JSON
} catch (e) {
console.log(e.name, "|", e.message);
}
try { JSON.parse(""); } catch (e) { console.log(e.message); }
try { JSON.parse('{"a":1,}'); } catch (e) { console.log(e.message); }
SyntaxError | Expected property name or '}' in JSON at position 1 (line 1 column 2)
Unexpected end of JSON input
Expected double-quoted property name in JSON at position 7 (line 1 column 8)
Текст сообщений зависит от движка и его версии, но тип ошибки — всегда SyntaxError.
Что теряется при stringify
console.log(JSON.stringify({ a: undefined, b: () => 1, c: Symbol("x"), d: null, e: NaN, f: Infinity }));
console.log(JSON.stringify([undefined, () => 1, Symbol("x")]));
console.log(JSON.stringify(undefined), JSON.stringify(() => 1));
console.log(JSON.stringify({ m: new Map([[1, 2]]), s: new Set([1, 2]) }));
console.log(JSON.stringify({ d: new Date(Date.UTC(2024, 4, 17)) }));
{"d":null,"e":null,"f":null}
[null,null,null]
undefined undefined
{"m":{},"s":{}}
{"d":"2024-05-17T00:00:00.000Z"}
- в объектах поля со значением
undefined, функцией или символом пропадают, в массивах превращаются вnull; NaNиInfinityстановятсяnull;MapиSetпревращаются в пустой объект{}— данные теряются;Dateстановится ISO-строкой, но обратно датой уже не станет;- значения
BigIntвызываютTypeError, а циклические ссылки — тожеTypeError(«Converting circular structure to JSON»).
toJSON и reviver
Если у объекта есть метод toJSON, stringify вызовет его и сериализует результат (именно так работает Date):
class Money {
constructor(amount, cur) { this.amount = amount; this.cur = cur; }
toJSON() { return `${this.amount} ${this.cur}`; }
}
console.log(JSON.stringify({ price: new Money(10, "USD") }));
{"price":"10 USD"}
Обратное преобразование — второй аргумент parse, reviver. Он вызывается для каждого значения и может вернуть другое:
const text = '{"d":"2024-05-17T00:00:00.000Z","n":1}';
const rev = JSON.parse(text, (key, value) => key === "d" ? new Date(value) : value);
console.log(rev.d instanceof Date, rev.d.getUTCFullYear());
true 2024
«Глубокое копирование» через JSON
Старый трюк JSON.parse(JSON.stringify(obj)) создаёт копию вложенных данных:
const copy = JSON.parse(JSON.stringify(user));
copy.address.city = "Брест";
console.log(user.address.city);
Минск
Но он теряет всё, что перечислено выше (даты, Map, undefined). Сегодня для копирования есть structuredClone(obj), который корректно копирует даты, Map и Set, но не умеет клонировать функции.
Не доверяйте JSON из сети: всегда проверяйте, что нужные поля есть и имеют нужный тип. JSON.parse гарантирует только то, что строка — валидный JSON, а не то, что структура ваша.
Сериализуйте объект { title: "Заказ", created: new Date(), items: new Map([["a", 1]]) }: сначала убедитесь, что Map теряется. Затем с помощью replacer превратите Map в массив пар ([...value]), а с помощью reviver восстановите из строки и Date, и Map. Напишите safeParse(text, fallback), возвращающую запасное значение при ошибке.
Оглавление курса
Модуль 1Старт10
- 1Что такое JavaScript и где он работает
- 2Инструменты: редактор и консоль браузера
- 3Первый скрипт: script, console.log и Node.js
- 4Переменные: let, const и var
- 5Типы данных
- 6Числа и объект Math
- 7Строки и шаблонные литералы
- 8Комментарии, стиль кода и точка с запятой
- 9Браузер и Node.js: чем отличаются среды
- 10История языка и стандарт ECMAScript
Модуль 2Операторы и управление потоком10
Модуль 3Функции10
Модуль 4Объекты и массивы10
Модуль 5Строки, числа, даты и данные10
Модуль 6DOM и события10
Модуль 7Браузерные API10
Модуль 8Прототипы и классы10
Модуль 9Асинхронность10
Модуль 10Модули и инструменты10
Модуль 11Продвинутые возможности10
Модуль 12Ошибки, тесты и безопасность10
Модуль 13Node.js10
Модуль 14Экосистема и фреймворки10
- 131TypeScript: типы в повседневной работе
- 132React: обзор
- 133Vue и Svelte: обзор
- 134Управление состоянием: обзор
- 135Мета-фреймворки: Next.js, Nuxt, SvelteKit
- 136Современные инструменты сборки
- 137Сквозные тесты: Playwright
- 138Паттерны проектирования в JavaScript
- 139Архитектура больших приложений
- 140Безопасность зависимостей
Модуль 15Профи10
- 141Движок V8 и JIT-компиляция
- 142Память и сборка мусора
- 143Event Loop глубже: микрозадачи и макрозадачи
- 144Производительность и Web Vitals
- 145Вопросы на собеседовании по JavaScript
- 146Алгоритмы и структуры данных на JavaScript
- 147Код-ревью
- 148Вклад в open source
- 149Дипломный проект: разработка
- 150Дипломный проект: защита и итоги
