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.