JavaScript · справочник

JSON в JavaScript

JSON — текстовый формат обмена данными. В JavaScript объект превращается в JSON-строку через JSON.stringify(), а строка восстанавливается через JSON.parse().

Сериализация

Функции, undefined и Symbol не представляются обычным JSON. Date превращается в строку, а циклическая ссылка вызывает ошибку.

const user = { name: 'Маша', active: true };
const json = JSON.stringify(user);
// {"name":"Маша","active":true}

Разбор и ошибки

JSON.parse требует корректные двойные кавычки и формат. Внешние или сохранённые данные разбирай внутри try...catch.

try {
  const data = JSON.parse(savedText);
  console.log(data.name);
} catch (error) {
  console.error('Повреждённый JSON', error);
}

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

• Одинарные кавычки в JSON.
• Parse без обработки ошибки.
• Хранить функции в JSON.
• Повторно stringify уже готовой строки.

JSON — это текст, не объект

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

В JSON нельзя передать функцию, undefined и комментарий. Дата превращается в строку. Если разобрать её обратно, получится строка, а не объект Date, пока ты сам её не преобразуешь.

const lesson = { title: "JSON", minutes: 15, draft: false };
const saved = JSON.stringify(lesson);
const restored = JSON.parse(saved);

if (restored.minutes < 1) {
  throw new Error("У урока странная длительность");
}

Ошибочный текст нужно поймать

Лишняя запятая, одинарные кавычки или обрезанный ответ сервера роняют JSON.parse. Оборачивай разбор в try/catch, если строка пришла откуда-то снаружи: из поля, из файла, из localStorage. Для собственного объекта, который ты только что сам собрал, падать там почти нечему.

После разбора проверь форму данных. То, что строка разобралась, не значит, что внутри есть title и что minutes — число. Одна проверка на обязательные поля спасает от странной отрисовки.

Как читать чужой JSON

• Открой его с отступами. Одна длинная строка прячет пропущенную скобку.
• Массив снаружи и объект снаружи — разные корни. Код должен ожидать тот, который реально пришёл.
• Не выводи весь JSON в интерфейс. Выбери поля, которые нужны человеку.
• Большой вложенный ответ приведи к плоскому объекту урока в одном месте, а не по всей странице.

Связанные темы

localStorage · try...catch · Объекты