Гайды

Почему пропадают данные из localStorage — четыре причины и как их проверить

Иллюстрация: ящик, из которого вещи рассыпаются в пыль

Ты попросил ИИ: «сохраняй список задач, чтобы не пропадал после перезагрузки». Он добавил localStorage. Ты добавляешь задачи, жмёшь F5 — пусто. Или вчера всё было, а сегодня нет. Или на ноутбуке есть, а на телефоне нет — ну, это как раз нормально.

Обидно, что ошибок в консоли ноль. localStorage не ругается — он просто молча отдаёт не то. Разберём причины от самой частой к редкой.

Первым делом научись смотреть, что там лежит на самом деле. Открой DevTools (F12) → вкладка Application → слева Local Storage → твой адрес. Там видно все ключи и значения. Это главный инструмент для всех четырёх проверок.

Причина 1: код сам затирает данные при загрузке

Самая частая, особенно в React. Типичный код от ИИ:

const [tasks, setTasks] = useState([]);

useEffect(() => {
  localStorage.setItem("tasks", JSON.stringify(tasks));
}, [tasks]);

На первом рендере tasks — пустой массив. Эффект срабатывает и честно сохраняет этот пустой массив. Поверх твоих вчерашних задач. А код, который должен их прочитать, либо отсутствует, либо срабатывает позже записи.

Как проверить. Добавь задачу, проверь в Application — она есть. Перезагрузи страницу и сразу смотри туда же. Если значение стало [] — это оно.

Как починить. Читай сохранённое прямо при создании состояния, до первой записи:

const [tasks, setTasks] = useState(() => {
  const saved = localStorage.getItem("tasks");
  return saved ? JSON.parse(saved) : [];
});

Функция внутри useState выполнится один раз при старте. Эффект сохранения после этого уже запишет загруженные задачи, а не пустоту.

Причина 2: другой адрес — другое хранилище

У каждого сайта своё хранилище. И «сайт» тут — это схема, домен и порт вместе. Поэтому localhost:3000, localhost:5173 и 127.0.0.1:3000 — три разных хранилища.

Ловится так: вчера проект запустился на одном порту, сегодня тот занят — и сборщик выбрал соседний. Данные никуда не делись, ты просто смотришь в другой ящик. Подробнее про это — в разборах localhost и портов.

Как проверить. Посмотри адресную строку. В Application слева бывает несколько адресов — загляни в каждый.

Как починить. Зафиксируй порт в настройках сборщика. И помни: превью-деплой и боевой сайт тоже разные адреса. Данные с одного на другой не переедут.

Причина 3: объект сохранился как «[object Object]»

localStorage хранит только строки. Передашь объект напрямую — он превратится в бесполезную строку "[object Object]". Прочитать его обратно уже нельзя.

С числами тоньше. Сохранил 5, прочитал "5". Потом "5" + 1 даёт "51", а не 6. Счётчик «ломается», хотя данные на месте.

Как проверить. В Application посмотри значение. Видишь [object Object] — причина найдена.

Как починить. Сохраняй через JSON.stringify, читай через JSON.parse. Про формат — в разборе JSON. Числа после чтения переводи обратно: Number(value).

Причина 4: браузер почистил всё сам

Бывает и такое, и это не баг твоего кода:

  • Режим инкогнито. Всё хранилище стирается, когда закрываешь окно.
  • Safari. Его защита от слежки (ITP) удаляет данные, записанные скриптом, если пользователь 7 дней пользовался Safari и ни разу не зашёл на твой сайт.
  • Пользователь очистил историю или браузер освободил место, когда диск почти полон.

Как починить. Принять как факт: localStorage — это кэш на устройстве, а не надёжное хранилище. Важное храни в базе данных на сервере. И раз уж на то пошло, данные одного устройства на другом никогда и не появятся.

Слабый промптlocalStorage не сохраняет данные, почини
Сильный промптВ React-компоненте список tasks сохраняется в localStorage через useEffect, но после перезагрузки страницы список пустой. Проверь, не затирает ли эффект сохранения данные пустым массивом на первом рендере. Перепиши так, чтобы tasks читался из localStorage в ленивом инициализаторе useState, с JSON.parse и запасным пустым массивом. Покажи компонент целиком.

Сколько данных влезает в localStorage?

Обычно около 5 МБ на сайт. Для настроек, черновиков и списков задач хватает с запасом. Для фото и больших файлов — нет.

А если у меня Next.js и пишет «localStorage is not defined»?

Next.js сначала рендерит страницу на сервере, а там нет браузера и нет localStorage. Ленивый инициализатор из причины 1 выполнится и там — и упадёт. В Next.js читай хранилище внутри useEffect, а рядом заведи флаг «загружено». Эффект сохранения пусть пишет, только когда флаг уже стоит. Тогда пустой массив не затрёт данные.

Можно ли хранить в localStorage пароль или токен?

Лучше не надо. Любой скрипт на странице может его прочитать. Для входа надёжнее cookie с флагом HttpOnly — до неё скрипты не дотягиваются.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →