Веб-разработка
Что такое 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>);
}
Частые вопросы
Чем TanStack Query лучше fetch в useEffect?
Он автоматически кеширует данные, убирает дубликаты запросов, повторяет неудачные запросы, обновляет устаревшие данные, отменяет лишние запросы и даёт готовые состояния загрузки и ошибки. Вручную это сотни строк кода.
Нужен ли Redux, если есть TanStack Query?
Часто нет. Большая часть «глобального состояния» — это данные с сервера, которыми и управляет TanStack Query. Для небольшого клиентского состояния хватает useState, контекста или Zustand.
Что такое staleTime?
Время, в течение которого данные считаются свежими и не перезапрашиваются. По умолчанию оно нулевое, так что данные обновляются в фоне при каждой возможности; увеличение staleTime уменьшает количество запросов.
Обучение фронтенд-разработке в OWU
Освойте фронтенд-разработку на практических курсах с менторами и реальными проектами.
Выбрать курс