TanStack Query как state-менеджер
TanStack Query (бывший React Query) задумывался для серверного состояния. Но многие используют его как state-менеджер вообще. Работает.
TanStack Query (раньше React Query) — библиотека для работы с серверным состоянием: загрузка, кеширование, инвалидация, мутации, повторный запрос при возвращении на вкладку. Формально это не state-менеджер. Но если посмотреть, что на самом деле лежит в глобальном сторе типичного React-приложения, окажется, что большая часть — копия данных с сервера. Именно эту часть TanStack Query забирает целиком, и Redux во многих проектах становится просто не нужен.
Серверное и клиентское состояние — разные вещи
Серверное состояние живёт в базе, а у вас в браузере лишь его снимок, который может устареть. Его нужно загрузить, закешировать, вовремя обновить и синхронизировать после изменений. Клиентское состояние существует только в интерфейсе: открыто ли меню, какая вкладка выбрана, что набрано в поле.
Классическая ошибка — складывать оба вида в один Redux-стор и вручную писать для серверных данных загрузку, флаги isLoading, обработку ошибок и логику «когда перезапросить». TanStack Query делает это из коробки и лучше.
Что закрывает TanStack Query
- Списки, карточки, справочники — любые данные с сервера.
- Производное глобальное состояние: текущий пользователь, права, настройки аккаунта — это тоже серверные данные.
- Кеш между страницами: вернулись на список — он показывается мгновенно и тихо обновляется.
- Оптимистичные обновления: интерфейс меняется сразу, а при ошибке откатывается.
- Фоновое обновление, повторы при сбое сети, дедупликация одинаковых запросов.
Базовый пример — список заказов с фильтром и мутация, после которой список обновляется:
const { data, isPending } = useQuery({
queryKey: ['orders', filters],
queryFn: () => api.getOrders(filters),
staleTime: 30_000,
});
const qc = useQueryClient();
const update = useMutation({
mutationFn: api.updateOrder,
onSuccess: () => qc.invalidateQueries({ queryKey: ['orders'] }),
});
Ключ ['orders', filters] — это и есть «адрес» данных в кеше. Инвалидация по префиксу ['orders'] обновит все варианты списка с любыми фильтрами.
Оптимистичные обновления устроены так же просто. Пользователь отмечает задачу выполненной, интерфейс сразу показывает галочку, а запрос уходит в фоне. В onMutate вы сохраняете текущий снимок кеша и вносите изменение, в onError возвращаете снимок обратно, в onSettled инвалидируете запрос, чтобы подтянуть актуальные данные с сервера. В Redux для такого писали отдельные экшены и десятки строк, здесь это три колбэка в одной мутации.
Что оставить другим инструментам
- Локальный UI-state (открыт ли модал, активная вкладка) —
useStateв компоненте. Если состояние нужно нескольким далёким компонентам — Zustand или контекст. - Фильтры, сортировка, пагинация — в URL. Тогда ссылку можно отправить коллеге, а кнопка «назад» работает как ожидается. Параметры из URL просто становятся частью
queryKey. - Формы — библиотека форм вроде React Hook Form. Черновик формы не серверное состояние, пока его не отправили.
- Сложная клиентская логика — редактор, конструктор, офлайн-режим с очередью изменений. Здесь нужен полноценный клиентский стор, и Zustand или Redux Toolkit оправданы.
В итоге типичное приложение обходится связкой «TanStack Query для серверных данных + URL для фильтров + немного Zustand для UI». Redux нужен там, где клиентская логика действительно сложная.
Типичные ошибки
- Копировать данные из запроса в useState или стор. Получаются два источника правды, которые расходятся. Берите данные прямо из
useQuery, а производные значения вычисляйте черезselect. - Хаотичные ключи. Договоритесь о структуре: сущность, затем параметры. Удобно вынести ключи в фабрику, чтобы не опечататься в строках.
- Нулевой staleTime везде. По умолчанию данные считаются устаревшими сразу, и при каждом монтировании компонента и фокусе окна уходит повторный запрос. Для справочников и редко меняющихся данных задавайте осмысленный
staleTime. - Путать staleTime и gcTime. Первый — сколько данные считаются свежими, второй — сколько неиспользуемые данные живут в кеше (в старых версиях он назывался
cacheTime). - Использовать Query как хранилище клиентского состояния через
setQueryDataбез сервера. Работает, но читается плохо. Для этого есть useState и Zustand. - Забывать про инвалидацию после мутаций. Пользователь сохранил изменения, а список показывает старое.
Как переводить существующий проект
Переписывать всё сразу не нужно. Подключите TanStack Query рядом с текущим стором и переносите по одной сущности: сначала справочники, потом списки, потом детальные экраны. После каждой сущности из Redux уходят экшены, редьюсеры и флаги загрузки. Когда в сторе остаётся только UI-состояние, его обычно легко пересадить на Zustand.
Архитектуру фронтенда закладываем в рамках разработки веб-приложений и внутренних админок и дашбордов, где серверных данных особенно много. Если приложение уже работает и обросло стором на тысячи строк, разбираем его в рамках поддержки веб-приложений.
Хотите разобраться, как упростить состояние в вашем React-приложении, — напишите в Telegram или MAX.