Phone icon Связаться с нами

Веб-разработка

Что такое TanStack Query (React Query)?

TanStack Query (ранее React Query) — это библиотека для получения, кеширования и обновления данных с сервера в React-приложениях. Она берёт на себя всю рутину, которую обычно пишут вручную в useEffect: состояния загрузки и ошибки, повторные попытки, отмену запросов, кеш и синхронизацию.

Данные получают хуком useQuery: ему передают уникальный ключ запроса (queryKey) и функцию, которая загружает данные. Библиотека хранит результат в кеше по ключу, так что другие компоненты с тем же ключом получают данные мгновенно, без повторного запроса. Изменения на сервере — создание, обновление, удаление — выполняют через useMutation.

TanStack Query автоматически обновляет устаревшие данные в фоне: при возвращении на вкладку, восстановлении соединения или через заданный интервал. Поддерживаются пагинация, бесконечная прокрутка, оптимистичные обновления, Suspense и серверный рендеринг.

Где применяется

Библиотеку используют в приложениях, которые много работают с API: каталоги, личные кабинеты, админ-панели, CRM, дашборды. Она существенно сокращает количество кода и убирает типичные ошибки с гонками запросов и устаревшими данными.

TanStack Query не заменяет менеджер клиентского состояния: данные с сервера хранятся в нём, а локальное состояние интерфейса — в useState, контексте или Zustand. Также есть версии библиотеки для Vue, Angular, Svelte и Solid.

Пример

Загрузка курсов и запись на курс с обновлением кеша.

import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';

function Courses() {
  const { data, isPending, isError, error } = useQuery({
    queryKey: ['courses'],
    queryFn: () => fetch('/api/courses').then(r => r.json()),
    staleTime: 60_000,
  });

  const queryClient = useQueryClient();
  const enroll = useMutation({
    mutationFn: (id) => fetch('/api/enroll/' + id, { method: 'POST' }),
    onSuccess: () => queryClient.invalidateQueries({ queryKey: ['courses'] }),
  });

  if (isPending) return <p>Loading...</p>;
  if (isError) return <p>Error: {error.message}</p>;
  return data.map(c => <button key={c.id} onClick={() => enroll.mutate(c.id)}>{c.title}</button>);
}
Хуки useQuery и useMutation и инвалидация кеша.

Частые вопросы

Чем TanStack Query лучше fetch в useEffect?

Он автоматически кеширует данные, убирает дубликаты запросов, повторяет неудачные запросы, обновляет устаревшие данные, отменяет лишние запросы и даёт готовые состояния загрузки и ошибки. Вручную это сотни строк кода.

Нужен ли Redux, если есть TanStack Query?

Часто нет. Большая часть «глобального состояния» — это данные с сервера, которыми и управляет TanStack Query. Для небольшого клиентского состояния хватает useState, контекста или Zustand.

Что такое staleTime?

Время, в течение которого данные считаются свежими и не перезапрашиваются. По умолчанию оно нулевое, так что данные обновляются в фоне при каждой возможности; увеличение staleTime уменьшает количество запросов.

Обучение фронтенд-разработке в OWU

Освойте фронтенд-разработку на практических курсах с менторами и реальными проектами.

Выбрать курс