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

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

Обрати курс