TanStack Query как state-менеджер

TanStack Query (бывший React Query) задумывался для серверного состояния. Но многие используют его как state-менеджер вообще. Работает.

TanStack Query как state-менеджер

TanStack Query (раньше React Query) — библиотека для работы с серверным состоянием: загрузка, кеширование, инвалидация, мутации, повторный запрос при возвращении на вкладку. Формально это не state-менеджер. Но если посмотреть, что на самом деле лежит в глобальном сторе типичного React-приложения, окажется, что большая часть — копия данных с сервера. Именно эту часть TanStack Query забирает целиком, и Redux во многих проектах становится просто не нужен.

TanStack Query как state-менеджер
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 нужен там, где клиентская логика действительно сложная.

Типичные ошибки

  1. Копировать данные из запроса в useState или стор. Получаются два источника правды, которые расходятся. Берите данные прямо из useQuery, а производные значения вычисляйте через select.
  2. Хаотичные ключи. Договоритесь о структуре: сущность, затем параметры. Удобно вынести ключи в фабрику, чтобы не опечататься в строках.
  3. Нулевой staleTime везде. По умолчанию данные считаются устаревшими сразу, и при каждом монтировании компонента и фокусе окна уходит повторный запрос. Для справочников и редко меняющихся данных задавайте осмысленный staleTime.
  4. Путать staleTime и gcTime. Первый — сколько данные считаются свежими, второй — сколько неиспользуемые данные живут в кеше (в старых версиях он назывался cacheTime).
  5. Использовать Query как хранилище клиентского состояния через setQueryData без сервера. Работает, но читается плохо. Для этого есть useState и Zustand.
  6. Забывать про инвалидацию после мутаций. Пользователь сохранил изменения, а список показывает старое.

Как переводить существующий проект

Переписывать всё сразу не нужно. Подключите TanStack Query рядом с текущим стором и переносите по одной сущности: сначала справочники, потом списки, потом детальные экраны. После каждой сущности из Redux уходят экшены, редьюсеры и флаги загрузки. Когда в сторе остаётся только UI-состояние, его обычно легко пересадить на Zustand.

Архитектуру фронтенда закладываем в рамках разработки веб-приложений и внутренних админок и дашбордов, где серверных данных особенно много. Если приложение уже работает и обросло стором на тысячи строк, разбираем его в рамках поддержки веб-приложений.

Хотите разобраться, как упростить состояние в вашем React-приложении, — напишите в Telegram или MAX.

Разработка веб-приложения
Услуга по теме — обсудим ваш проект.

Есть задача по теме? Напишите — вернёмся с оценкой и сроками.

Написать в Telegram → Написать в MAX