Тестирование TanStack Query и стейт-менеджеров
На этой странице
Серверное состояние (TanStack Query, RTK Query, SWR) и клиентские сторы (Zustand, Redux Toolkit, Jotai) тестируют через поведение, а не через внутренности библиотеки. Для TanStack Query: свежий QueryClient на каждый тест с retry: false, сеть — через MSW, компонент или хук рендерится внутри QueryClientProvider; проверяются загрузка, данные, ошибка, инвалидация после мутации (список обновился после добавления), оптимистичные обновления и откат. Кастомные хуки запросов можно проверить через renderHook и waitFor(() => result.current.isSuccess). Для сторов: логику стора (экшены, селекторы, редьюсеры) тестируют unit-тестами напрямую, а компоненты — с настоящим стором, созданным с нужным начальным состоянием; стор сбрасывают между тестами. Мок самого хука (vi.mock("./useOrders")) делает тест быстрым, но он перестаёт проверять ключи кэша, инвалидацию и обработку ошибок — используй его только для изоляции тяжёлых частей.
Вопрос
Как тестировать компоненты и хуки, использующие TanStack Query, и как тестировать сторы Zustand и Redux Toolkit?
TanStack Query: хук запроса
// entities/order/api/use-orders.ts
export function useOrders(status?: OrderStatus) {
return useQuery({
queryKey: ["orders", { status }],
queryFn: ({ signal }) => api.getOrders({ status }, { signal }),
});
}import { renderHook, waitFor } from "@testing-library/react";
import { QueryClientProvider } from "@tanstack/react-query";
import { createTestQueryClient } from "@/test/utils";
function createWrapper() {
const client = createTestQueryClient();
return ({ children }: { children: React.ReactNode }) => (
<QueryClientProvider client={client}>{children}</QueryClientProvider>
);
}
it("возвращает заказы с нужным статусом", async () => {
server.use(http.get("/api/orders", ({ request }) => {
const status = new URL(request.url).searchParams.get("status");
return HttpResponse.json([buildOrder({ id: "1", status: status as OrderStatus })]);
}));
const { result } = renderHook(() => useOrders("paid"), { wrapper: createWrapper() });
await waitFor(() => expect(result.current.isSuccess).toBe(true));
expect(result.current.data).toEqual([expect.objectContaining({ id: "1", status: "paid" })]);
});
it("переходит в ошибку при 500", async () => {
server.use(http.get("/api/orders", () => HttpResponse.json({}, { status: 500 })));
const { result } = renderHook(() => useOrders(), { wrapper: createWrapper() });
await waitFor(() => expect(result.current.isError).toBe(true));
});Инвалидация после мутации (через UI)
it("после добавления задачи список обновляется", async () => {
let todos = [{ id: "1", title: "Первая" }];
server.use(
http.get("/api/todos", () => HttpResponse.json(todos)),
http.post("/api/todos", async ({ request }) => {
const { title } = (await request.json()) as { title: string };
todos = [...todos, { id: "2", title }];
return HttpResponse.json(todos.at(-1), { status: 201 });
}),
);
const { user } = renderWithProviders(<TodosPage />);
expect(await screen.findByText("Первая")).toBeInTheDocument();
await user.type(screen.getByRole("textbox", { name: "Новая задача" }), "Вторая{Enter}");
expect(await screen.findByText("Вторая")).toBeInTheDocument(); // пришло из refetch после invalidateQueries
});Тест не знает про invalidateQueries — он проверяет, что пользователь увидит обновлённый список. Если завтра инвалидацию заменят на setQueryData, тест останется зелёным.
Предзаполненный кэш
it("показывает данные из кэша без запроса", () => {
const client = createTestQueryClient(); // staleTime: Infinity — запроса не будет
client.setQueryData(["orders", "42"], buildOrder({ id: "42", title: "Заказ №42" }));
render(
<QueryClientProvider client={client}>
<OrderTitle id="42" />
</QueryClientProvider>,
);
expect(screen.getByRole("heading", { name: "Заказ №42" })).toBeInTheDocument(); // сразу, без findBy
});Предзаполнение полезно для тестов отображения, но проверку реальной загрузки оставляй MSW-тестам.
Zustand
// features/cart/model/cart-store.ts
export const createCartStore = (initial?: Partial<CartState>) =>
createStore<CartState & CartActions>()((set, get) => ({
items: [],
...initial,
add: (product) => set((s) => {
const existing = s.items.find((i) => i.id === product.id);
return existing
? { items: s.items.map((i) => (i.id === product.id ? { ...i, qty: i.qty + 1 } : i)) }
: { items: [...s.items, { ...product, qty: 1 }] };
}),
total: () => get().items.reduce((sum, i) => sum + i.price * i.qty, 0),
}));// Unit: логика стора без React
it("увеличивает количество при повторном добавлении", () => {
const store = createCartStore();
store.getState().add({ id: "a", price: 100 });
store.getState().add({ id: "a", price: 100 });
expect(store.getState().items).toEqual([{ id: "a", price: 100, qty: 2 }]);
expect(store.getState().total()).toBe(200);
});Для глобального стора, созданного через create(), сбрасывай состояние после каждого теста:
const initialState = useCartStore.getState();
afterEach(() => useCartStore.setState(initialState, true));Официальная документация Zustand предлагает автоматический сброс всех сторов через мок модуля zustand в __mocks__ — удобно в больших проектах.
Redux Toolkit
// Unit: редьюсер слайса
it("добавляет товар", () => {
const state = cartSlice.reducer(undefined, cartSlice.actions.added({ id: "a", price: 100 }));
expect(state.items).toHaveLength(1);
});
// Селекторы
it("считает сумму", () => {
expect(selectTotal({ cart: { items: [{ id: "a", price: 100, qty: 3 }] } } as RootState)).toBe(300);
});// Интеграция: настоящий стор с preloadedState
export function renderWithStore(ui: React.ReactElement, { preloadedState }: { preloadedState?: Partial<RootState> } = {}) {
const store = setupStore(preloadedState); // новая фабрика стора на каждый тест
return { store, ...render(<Provider store={store}>{ui}</Provider>) };
}
it("кнопка удаляет товар из корзины", async () => {
const user = userEvent.setup();
const { store } = renderWithStore(<Cart />, { preloadedState: { cart: { items: [{ id: "a", title: "Чайник", price: 100, qty: 1 }] } } });
await user.click(screen.getByRole("button", { name: "Удалить «Чайник»" }));
expect(screen.getByText("Корзина пуста")).toBeInTheDocument();
expect(store.getState().cart.items).toHaveLength(0); // допустимо, но UI-проверки обычно достаточно
});Thunks и RTK Query тестируются как интеграция: настоящий стор + MSW.
Что тестировать на каком уровне
| Что | Как |
|---|---|
| Редьюсер, экшены, селекторы, логика стора | Unit без React |
| Хук запроса с параметрами | renderHook + MSW |
| Компонент с данными | renderWithProviders + MSW, проверка UI |
| Мутация + обновление списка | Через UI + stateful MSW-хэндлеры |
| Оптимистичное обновление и откат | Через UI + MSW с ошибкой |
Персистентность (persist в localStorage) | Проверить запись/чтение, очищать localStorage в afterEach |
Что важно помнить
- Новый QueryClient и стор на каждый тест;
retry: false. - Сеть — через MSW, а не мок хуков запросов.
- Инвалидацию и оптимистичные обновления проверяй через результат в UI.
- Логику стора — unit-тестами, компоненты — с настоящим стором.
- Сбрасывай глобальные сторы и
localStorageмежду тестами.
Мини-шпаргалка
renderHook(() => useX(), { wrapper })+waitFor(() => result.current.isSuccess).queryClient.setQueryData(key, data)для предзаполнения.- Zustand: фабрика
createStoreилиsetState(initial, true)вafterEach. - RTK:
slice.reducer(state, action),setupStore(preloadedState).