ENRU

"undefined" is not valid JSON: в JSON.parse попало не то значение

Обновлено

SyntaxError: "undefined" is not valid JSON — перевод: «"undefined" — невалидный JSON». К твоему JSON это отношения не имеет. В JSON.parse передали undefined, он превратил его в девять букв undefined и отказался их разбирать. Близнец этой ошибки, "[object Object]" is not valid JSON, значит, что передали объект — обычно уже разобранный. JSON не было; была переменная, в которой он должен был лежать. Исправлять надо там, откуда пришло значение.

Почему JSON.parse так пишет

JSON.parse сначала приводит аргумент к строке. undefined становится "undefined", любой обычный объект — "[object Object]", промис — "[object Promise]". Ничто из этого не JSON: RFC 8259 разрешает ровно три слова без кавычек — true, false и null, — и undefined среди них нет. Ловушка — null: он становится "null", а это валидный JSON, поэтому JSON.parse(null) молча возвращает null.

АргументСообщение V8 (Node.js 25.1, Chrome 156)Что случилось
undefinedSyntaxError: "undefined" is not valid JSONЗначение так и не задали
строка "undefined"SyntaxError: "undefined" is not valid JSONundefined раньше сохранили текстом
{ id: 42 }SyntaxError: "[object Object]" is not valid JSONУже разобрано или сохранено без JSON.stringify
[{ id: 42 }]SyntaxError: "[object Object]" is not valid JSONМассив объектов превращается в тот же текст
PromiseSyntaxError: Unexpected token 'o', "[object Promise]" is not valid JSONПропущен await; «неожиданный токен „o“» — вторая буква [object
ResponseSyntaxError: Unexpected token 'o', "[object Response]" is not valid JSONПередали res вместо await res.text()
nullошибки нет, возвращает nulllocalStorage.getItem отсутствующего ключа

Короткую форму без «Unexpected token» V8 даёт для undefined, NaN, Infinity и [object Object]; для остального текста — длинную, с первым неверным символом.

Та же ошибка в других движках

Движок, проверенная версияJSON.parse(undefined)JSON.parse({})
Chrome 156, Node.js 20.20 и 25.1 (V8)"undefined" is not valid JSON"[object Object]" is not valid JSON
Node.js 18.20 (V8 10.2)Unexpected token u in JSON at position 0 — «неожиданный токен u на позиции 0»Unexpected token o in JSON at position 1 — «неожиданный токен o на позиции 1»
Firefox (исходник: SpiderMonkey)JSON.parse: unexpected character at line 1 column 1 of the JSON data — «неожиданный символ в строке 1, колонке 1»JSON.parse: unexpected character at line 1 column 2 of the JSON data — то же в колонке 2
Safari, JavaScriptCore из macOS 27.0.1JSON Parse error: Unexpected identifier "undefined" — «неожиданный идентификатор»JSON Parse error: Unexpected identifier "object" — то же для object
React Native, Hermes (исходник)JSON Parse error: Unexpected character: u — «неожиданный символ: u»JSON Parse error: Unexpected character: o — «неожиданный символ: o»
Python 3.9.6 и 3.14.10, json.loads(None) и json.loads({})TypeError: the JSON object must be str, bytes or bytearray, not NoneTypeTypeError: the JSON object must be str, bytes or bytearray, not dict

Старая формулировка V8 объясняет давнюю загадку: в Unexpected token o in JSON at position 1 буква o — вторая в [object Object], а в Unexpected token u in JSON at position 0 буква u открывает undefined. Python отвергает неверный тип ещё до разбора, поэтому у него TypeError («объект JSON должен быть str, bytes или bytearray, а не dict»), а не JSONDecodeError.

Откуда берётся неверное значение

undefined

  • Хранилище, прочитанное как свойство. localStorage.user для отсутствующего ключа равно undefined, а localStorage.getItem('user') — null.
  • undefined, сохранённый текстом. И localStorage.setItem('user', undefined), и setItem('user', JSON.stringify(undefined)) записывают текст undefined: JSON.stringify(undefined) возвращает undefined, а хранилище превращает его в строку. Ошибка всплывает при следующей загрузке страницы, далеко от места, где её сделали.
  • Нет поля или атрибута. JSON.parse(el.dataset.config) без атрибута data-config или JSON.parse(body.payload), когда отправитель не прислал поле.
  • Незаданная переменная окружения, как в JSON.parse(process.env[name]).
  • Функция без return, результат которой сразу идёт в JSON.parse.

[object Object]

  • Двойной разбор. await res.json(), response.data у axios, jQuery с dataType: 'json' и Express с express.json() уже отдают объекты. Повторный разбор даёт эту ошибку.
  • Сохранили без JSON.stringify. localStorage.setItem('user', user) записывает текст [object Object].
  • Склейка строк. Шаблонная строка, String(user) и '' + user дают [object Object].
  • postMessage. event.data приходит структурированной копией, то есть уже объектом, — если только отправитель не вызвал JSON.stringify.

[object Promise] и [object Response]

Пропущенный await: JSON.parse(res.json()) передаёт промис, а JSON.parse(res) — сам объект ответа. Достаточно await res.json() — и больше ничего.

Исправление: разбирать только строки, сохранять только через stringify

Выяснить, что на самом деле попало в парсер, исправить код, который это записал, и научить чтение переживать то, что уже сохранено. Проверено в Chrome 156:

console.log(typeof value, value);

localStorage.setItem('user', JSON.stringify(user));

function readStored(key, fallback = null) {
  const raw = localStorage.getItem(key);
  if (raw === null || raw === 'undefined') return fallback;
  try {
    return JSON.parse(raw);
  } catch {
    return fallback;
  }
}

const data = typeof body === 'string' ? JSON.parse(body) : body;

TypeScript с честными типами ловит большую часть этого ещё при компиляции. В режиме strict передача string | undefined в JSON.parse даёт ошибку TS2345: «Argument of type 'string | undefined' is not assignable to parameter of type 'string'.» — «аргумент типа string | undefined нельзя передать в параметр типа string» (TypeScript 5.9.3). Приведение через as string или any выключает проверку и возвращает ошибку в рантайм.

Как не допустить

  • Одна пара функций для хранилища: запись всегда через JSON.stringify, чтение — с проверкой.
  • Разбор доверить HTTP-клиенту. res.json(), axios и express.json() возвращают объекты — их результат повторно не разбирать.
  • Вход парсера типизировать как string, никогда как any.
  • Один раз прибраться: удалить сохранённые ключи со значением undefined или [object Object], чтобы старые посетители перестали ловить ошибку.

Попробовать

Вставь в валидатор тот текст, который у тебя на самом деле есть. Слово undefined без кавычек он назовёт недопустимым литералом, потому что JSON знает только true, false и null; см. недопустимый литерал.

Ещё по теме: Unexpected token '<' — когда вместо JSON пришла веб-страница, Unexpected end of JSON input — пустой текст, и все ошибки JSON.

Вопросы о «"undefined" is not valid JSON»

Почему JSON.parse(undefined) падает, а JSON.parse(null) — нет?

Оба сначала превращаются в строки. null становится "null", а это валидный JSON; undefined становится "undefined", а это нет.

Что значит «"[object Object]" is not valid JSON»?

Перевод: «"[object Object]" — невалидный JSON». В JSON.parse пришёл объект, а не строка. Обычно это уже разобранные данные, которые разбирают второй раз, или объект, сохранённый без JSON.stringify.

Сервер прислал битый JSON?

Нет. Сообщение — про аргумент, а не про ответ. Залогируй typeof value прямо перед вызовом, и станет видно, что пришло.

Почему ошибка появляется только после перезагрузки?

Раньше что-то сохранило текст undefined или [object Object], а перезагрузка читает его обратно. Исправить запись и удалить испорченный ключ.