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

Unit-тесты логики: утилиты, редьюсеры, валидация и хуки

На этой странице
Кратко

Unit-тесты дают максимум пользы на чистой логике: функциях без побочных эффектов, которые принимают данные и возвращают результат. Во фронтенде это форматтеры (деньги, даты, склонения), расчёты (корзина, скидки, налоги), парсеры и мапперы DTO → модель, схемы валидации (Zod), редьюсеры и конечные автоматы, селекторы, правила доступа. Такие тесты пишутся быстро, выполняются за миллисекунды и не ломаются при изменении UI. Поэтому архитектурный приём «вынести логику из компонента в чистую функцию» одновременно улучшает код и делает его тестируемым. Кастомные хуки тестируются через renderHook из Testing Library (с act для обновлений и wrapper для провайдеров), но если хук используется в одном компоненте, обычно проще проверить компонент целиком. Сложную логику хука лучше вынести в чистую функцию или редьюсер и тестировать её напрямую.

Вопрос

Какую логику во фронтенде выгоднее всего покрывать unit-тестами и как это делать? Как тестировать кастомные хуки?

Вынеси логику — и тестировать станет легко

// ✗ Логика внутри компонента — проверить можно только через рендер
function CartSummary({ items, promo }: Props) {
  const subtotal = items.reduce((s, i) => s + i.price * i.qty, 0);
  const discount = promo?.type === "percent" ? Math.round((subtotal * promo.value) / 100) : promo?.value ?? 0;
  const total = Math.max(0, subtotal - discount);
  return <p>Итого: {formatPrice(total)}</p>;
}
 
// ✓ Чистая функция + тонкий компонент
export function calculateCart(items: CartItem[], promo?: Promo) {
  const subtotal = items.reduce((s, i) => s + i.price * i.qty, 0);
  const discount = !promo ? 0 : promo.type === "percent" ? Math.round((subtotal * promo.value) / 100) : promo.value;
  return { subtotal, discount, total: Math.max(0, subtotal - discount) };
}
describe("calculateCart", () => {
  it("возвращает нули для пустой корзины", () => {
    expect(calculateCart([])).toEqual({ subtotal: 0, discount: 0, total: 0 });
  });
  it("округляет процентную скидку до целых копеек", () => {
    expect(calculateCart([{ price: 333, qty: 1 }], { type: "percent", value: 10 }).discount).toBe(33);
  });
  it("не уходит в минус, если фиксированная скидка больше суммы", () => {
    expect(calculateCart([{ price: 100, qty: 1 }], { type: "fixed", value: 500 }).total).toBe(0);
  });
});

Валидация (Zod)

const SignupSchema = z.object({
  email: z.email("Некорректный email"),
  password: z.string().min(8, "Минимум 8 символов"),
  confirm: z.string(),
}).refine((d) => d.password === d.confirm, { path: ["confirm"], message: "Пароли не совпадают" });
 
it("сообщает о несовпадении паролей в поле confirm", () => {
  const result = SignupSchema.safeParse({ email: "a@b.ru", password: "12345678", confirm: "1234567x" });
  expect(result.success).toBe(false);
  expect(z.flattenError(result.error!).fieldErrors.confirm).toEqual(["Пароли не совпадают"]);
});

Схему, общую для клиента и сервера, достаточно протестировать один раз — и обе стороны получают гарантию.

Мапперы DTO

it("преобразует DTO заказа в модель", () => {
  const dto = { order_id: "42", total_kopecks: 150000, created_at: "2026-01-10T10:00:00Z", status: "PAID" };
  expect(toOrder(dto)).toEqual({ id: "42", total: 1500, createdAt: new Date("2026-01-10T10:00:00Z"), status: "paid" });
});
 
it("бросает ошибку при неизвестном статусе", () => {
  expect(() => toOrder({ ...validDto, status: "WAT" })).toThrow(/status/);
});

Редьюсеры и автоматы

it.each([
  ["idle",       { type: "SUBMIT" }, "submitting"],
  ["submitting", { type: "SUCCESS" }, "success"],
  ["submitting", { type: "FAIL" },    "error"],
  ["error",      { type: "SUBMIT" },  "submitting"],
  ["success",    { type: "SUBMIT" },  "success"],      // запрещённый переход игнорируется
] as const)("%s + %o → %s", (from, event, to) => {
  expect(formReducer({ status: from }, event).status).toBe(to);
});

Для XState удобно проверять переходы через getNextSnapshot(machine, snapshot, event) без запуска актора.

Кастомные хуки: renderHook

import { renderHook, act } from "@testing-library/react";
 
it("useToggle переключает значение", () => {
  const { result } = renderHook(() => useToggle(false));
  act(() => result.current.toggle());
  expect(result.current.value).toBe(true);
});
 
it("useDebouncedValue обновляется после задержки", () => {
  vi.useFakeTimers();
  const { result, rerender } = renderHook(({ value }) => useDebouncedValue(value, 300), {
    initialProps: { value: "a" },
  });
  rerender({ value: "ab" });
  expect(result.current).toBe("a");
  act(() => vi.advanceTimersByTime(300));
  expect(result.current).toBe("ab");
  vi.useRealTimers();
});

Хуки, которым нужен контекст (Query, роутер, тема), получают wrapper:

const { result } = renderHook(() => useCart(), {
  wrapper: ({ children }) => <CartProvider initialItems={[item]}>{children}</CartProvider>,
});

Когда renderHook, а когда компонент

renderHookТест компонента
Хук — переиспользуемая библиотечная единица (useDebounce, useLocalStorage)Хук используется в одном месте
Есть сложные граничные случаи, которые трудно вызвать через UIПоведение проще описать через действия пользователя

Права доступа

it.each([
  [{ role: "admin", id: "u1" }, { ownerId: "u2" }, true],
  [{ role: "user",  id: "u1" }, { ownerId: "u1" }, true],
  [{ role: "user",  id: "u1" }, { ownerId: "u2" }, false],
  [{ role: "guest", id: "g1" }, { ownerId: "g1" }, false],
])("can(%o, cancel, %o) = %s", (user, order, expected) => {
  expect(can(user, "order:cancel", order)).toBe(expected);
});

Одна и та же функция can используется на сервере для защиты и на клиенте для скрытия кнопок — тест защищает обе стороны.

Что важно помнить

  • Самая выгодная цель unit-тестов — чистая логика: расчёты, форматтеры, мапперы, схемы, редьюсеры, права.
  • Выноси логику из компонентов в функции — код становится и чище, и тестируемее.
  • Таблицы примеров (it.each) для правил и переходов.
  • Хуки — через renderHook + act + wrapper, если хук переиспользуемый.

Мини-шпаргалка

  • Логика → чистая функция → unit-тест.
  • schema.safeParse + z.flattenError.
  • Редьюсер: таблица [from, event, to].
  • renderHook(() => useX(), { wrapper, initialProps }), act, rerender.

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

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

Поиск

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