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

> Исправить "undefined" is not valid JSON и "[object Object]": найти, какое значение попало в JSON.parse: хранилище, пропущенный await, двойной разбор.

- Адрес: https://jsonstatham.dev/ru/errors/undefined-is-not-valid-json/
- Язык: Русский (ru)
- Английская версия: https://jsonstatham.dev/errors/undefined-is-not-valid-json.md
- Обновлено: 2026-11-08

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

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

[`JSON.parse`](https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse) сначала приводит аргумент к строке. `undefined` становится `"undefined"`, любой обычный объект — `"[object Object]"`, промис — `"[object Promise]"`. Ничто из этого не JSON: [RFC 8259](https://www.rfc-editor.org/rfc/rfc8259) разрешает ровно три слова без кавычек — `true`, `false` и `null`, — и `undefined` среди них нет. Ловушка — `null`: он становится `"null"`, а это валидный JSON, поэтому `JSON.parse(null)` молча возвращает `null`.

| Аргумент | Сообщение V8 (Node.js 25.1, Chrome 156) | Что случилось |
| --- | --- | --- |
| `undefined` | `SyntaxError: "undefined" is not valid JSON` | Значение так и не задали |
| строка `"undefined"` | `SyntaxError: "undefined" is not valid JSON` | `undefined` раньше сохранили текстом |
| `{ id: 42 }` | `SyntaxError: "[object Object]" is not valid JSON` | Уже разобрано или сохранено без `JSON.stringify` |
| `[{ id: 42 }]` | `SyntaxError: "[object Object]" is not valid JSON` | Массив объектов превращается в тот же текст |
| `Promise` | `SyntaxError: Unexpected token 'o', "[object Promise]" is not valid JSON` | Пропущен `await`; «неожиданный токен „o“» — вторая буква `[object` |
| `Response` | `SyntaxError: Unexpected token 'o', "[object Response]" is not valid JSON` | Передали `res` вместо `await res.text()` |
| `null` | ошибки нет, возвращает `null` | `localStorage.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.1 | `JSON 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 NoneType` | `TypeError: 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')`](https://developer.mozilla.org/ru/docs/Web/API/Storage/getItem) — `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:

```js
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]`, чтобы старые посетители перестали ловить ошибку.

## Попробовать

Вставь в [валидатор](https://jsonstatham.dev/ru/validator/?sample=invalid_literal) тот текст, который у тебя на самом деле есть. Слово `undefined` без кавычек он назовёт недопустимым литералом, потому что JSON знает только `true`, `false` и `null`; см. [недопустимый литерал](https://jsonstatham.dev/ru/errors/invalid-literal/).

Ещё по теме: [Unexpected token '<'](https://jsonstatham.dev/ru/errors/unexpected-token/) — когда вместо JSON пришла веб-страница, [Unexpected end of JSON input](https://jsonstatham.dev/ru/errors/unexpected-end-of-json-input/) — пустой текст, и [все ошибки JSON](https://jsonstatham.dev/ru/errors/).

## Вопросы о «"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]`, а перезагрузка читает его обратно. Исправить запись и удалить испорченный ключ.
