SWR
На этой странице
SWR — библиотека кеширования и загрузки данных для React. Название отражает подход stale-while-revalidate: показать кеш и обновить его в фоне.
Вопрос
Как SWR использует кеш и какие состояния возвращает useSWR?
Основная идея
Когда пользователь возвращается к профилю, полезно сразу показать последнее известное имя и проверить обновления в фоне. Если ответ изменился, интерфейс обновится. Если сети нет, старые данные могут остаться полезными, но это не гарантирует полноценную работу приложения офлайн.
useSWR получает ключ и fetcher. Ключ описывает данные: URL, массив с параметрами или другое поддерживаемое значение. Fetcher выполняет реальную загрузку и должен выбрасывать ошибку при неуспешном HTTP-ответе. Сам SWR не угадывает, что статус 500 означает проблему вашей функции.
Библиотека предоставляет данные, ошибку и признаки загрузки. isLoading описывает начальную загрузку без полученных данных, isValidating — любой выполняющийся запрос, включая фоновый. Для записи на сервер используют мутации, после которых обновляют кеш или инициируют ревалидацию.
Пример
Клиентское React-приложение с установленным пакетом swr; /api/users/me возвращает { name: string }.
import useSWR from 'swr';
async function fetcher(url) {
const response = await fetch(url);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
return response.json();
}
export default function Profile() {
const { data, error, isLoading, isValidating, mutate } = useSWR(
'/api/users/me', fetcher
);
if (isLoading) return <p role="status">Загрузка профиля...</p>;
if (error && !data) return <p role="alert">Профиль недоступен</p>;
return <>
<h2>{data.name}</h2>
{isValidating && <small>Проверяем обновления...</small>}
{error && <p role="alert">Показаны последние известные данные</p>}
<button onClick={() => mutate()}>Обновить</button>
</>;
}Первый запрос показывает loader. Следующий mutate() проверяет тот же ресурс и сохраняет профиль на экране. Ошибка фонового запроса не уничтожает полезные кешированные данные.
Stale-while-revalidate по шагам
1-й визит: кэша нет → isLoading → запрос → data → показали
Уход и возврат на страницу:
кэш есть → СРАЗУ показали старые data (stale)
→ в фоне запрос (isValidating = true) (revalidate)
→ пришли новые data → экран обновилсяНазвание взято из HTTP-директивы Cache-Control: stale-while-revalidate: отдать устаревшее мгновенно, а свежее подтянуть в фоне.
SWR или TanStack Query
| SWR | TanStack Query | |
|---|---|---|
| Размер и API | Меньше, проще | Больше возможностей |
| Ключ | URL/массив | Массив queryKey |
| Мутации | mutate, useSWRMutation | useMutation, onMutate/onError для оптимистичных обновлений |
| Инвалидация группы ключей | Через фильтр в mutate | invalidateQueries({ queryKey: [...] }) |
| DevTools | Сторонние | Официальные |
| Бесконечная лента | useSWRInfinite | useInfiniteQuery |
| Экосистема | Vercel, проще для небольших проектов | Шире: SSR-гидратация, офлайн, persist |
Оба решают одну задачу — кэш серверного состояния. Выбор чаще определяется размером проекта и привычками команды.
Глобальные настройки
import { SWRConfig } from "swr";
<SWRConfig value={{ fetcher, revalidateOnFocus: false, dedupingInterval: 5000 }}>
<App />
</SWRConfig>Что важно помнить
- Пример требует установленного SWR 2.
- Дедупликация действует по ключу и настройкам библиотеки; это не обещание единственного запроса навсегда.
- Ревалидация при фокусе и восстановлении сети настраивается.
- Изменение кеша не записывает данные на сервер: мутацию нужно выполнить отдельно.
Мини-шпаргалка
Ключ + fetcher → данные/ошибка. isLoading → первый результат. isValidating → сеть. mutate → обновление.