Почему пропадают данные из 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 коротких урока на телефоне.





