re:re:actable
Урок 026 минут чтения

Тестирование 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).

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам