Веб-розробка
Що таке 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
Опануйте фронтенд-розробку на практичних курсах із менторами та реальними проєктами.
Обрати курс