Тестируемый код: как проектировать фронтенд под тесты
На этой странице
Если код трудно тестировать, обычно проблема не в тестах, а в дизайне кода: всё смешано в одном компоненте, зависимости захардкожены, логика спрятана в эффектах, глобальное состояние меняется откуда угодно. Тестируемый код почти всегда оказывается и более понятным. Принципы: разделять логику и представление (чистые функции и хуки отдельно, компонент — тонкий слой разметки), выделять побочные эффекты на границы (сеть, хранилища, время, случайность — за небольшими модулями или передаются зависимостями), передавать зависимости явно (props, параметры функций, контекст или DI на уровне composition root, а не прямые импорты синглтонов внутри логики), делать компоненты управляемыми снаружи (controlled/uncontrolled, начальные значения через props), использовать семантичную и доступную разметку (тогда getByRole работает «из коробки»), избегать скрытого глобального состояния (фабрики сторов, а не модульные синглтоны с мутациями). Признак хорошего дизайна: для большинства тестов достаточно мокать только сеть и время.
Вопрос
Как писать фронтенд-код так, чтобы его было легко тестировать? Какие признаки плохо тестируемого кода и как их исправить?
Признаки плохо тестируемого кода
| Признак | Почему мешает | Исправление |
|---|---|---|
| Логика расчётов внутри JSX и обработчиков | Проверить можно только через рендер | Вынести в чистую функцию |
fetch прямо в компоненте | Нужно мокать глобальный fetch | API-слой + MSW / хук данных |
Date.now(), Math.random() в глубине логики | Недетерминизм | Передавать now/генератор параметром или мокать на границе |
Импорт синглтона (analytics, store) внутри логики | Трудно подменить | Передать зависимость / провайдер |
| Огромный компонент на 600 строк | Много состояний и путей | Разделить на компоненты и хуки |
Цепочки useEffect, синхронизирующие состояние | Сложные асинхронные гонки в тестах | Вычислять при рендере, события вместо эффектов |
| Нет ролей и подписей (div-кнопки) | Нельзя найти по роли | Семантичная разметка |
| Модульное мутабельное состояние | Тесты влияют друг на друга | Фабрики, провайдеры, сброс |
Логика отдельно от представления
// ✗ Всё вместе
function Checkout() {
const [items, setItems] = useState<Item[]>([]);
useEffect(() => { fetch("/api/cart").then((r) => r.json()).then(setItems); }, []);
const delivery = items.reduce((s, i) => s + i.price * i.qty, 0) > 5000 ? 0 : 390;
// …ещё 200 строк
}
// ✓ Слои
// entities/cart/model/delivery.ts — чистая функция (unit)
export const calcDelivery = (subtotal: number, rules = DEFAULT_RULES) => (subtotal >= rules.freeFrom ? 0 : rules.price);
// entities/cart/api/use-cart.ts — данные (renderHook + MSW)
export const useCart = () => useQuery({ queryKey: ["cart"], queryFn: api.getCart });
// widgets/checkout/checkout.tsx — тонкий компонент (RTL + MSW)
function Checkout() {
const { data: cart, isPending, error } = useCart();
if (isPending) return <CheckoutSkeleton />;
if (error) return <ErrorState onRetry={…} />;
return <CheckoutView cart={cart} delivery={calcDelivery(cart.subtotal)} />;
}
// widgets/checkout/checkout-view.tsx — презентационный (Storybook + визуальные тесты)Зависимости явно
// ✗ Скрытая зависимость от времени и хранилища
export function isTrialExpired() {
const startedAt = Number(localStorage.getItem("trialStart"));
return Date.now() - startedAt > 14 * DAY;
}
// ✓ Логика чистая; эффекты на краях
export function isTrialExpired(startedAt: number, now: number) {
return now - startedAt > 14 * DAY;
}
// Использование: isTrialExpired(trialStore.get(), Date.now())it.each([
[0, 14 * DAY, false],
[0, 14 * DAY + 1, true],
])("триал с %i на момент %i истёк: %s", (start, now, expected) => {
expect(isTrialExpired(start, now)).toBe(expected);
});Порты и адаптеры для внешних сервисов
// shared/analytics/port.ts
export interface Analytics { track(event: string, props?: Record<string, unknown>): void }
// app/providers.tsx — composition root выбирает реализацию
<AnalyticsProvider value={process.env.NODE_ENV === "test" ? noopAnalytics : segmentAnalytics}>
// В тесте — фейк, который запоминает события
const analytics = { events: [] as string[], track(e: string) { this.events.push(e); } };
renderWithProviders(<BuyButton />, { analytics });
await user.click(screen.getByRole("button", { name: "Купить" }));
expect(analytics.events).toContain("purchase_click");Так тесты не зависят от SDK аналитики, платёжного виджета или карт.
Компоненты, управляемые снаружи
// Можно отрендерить в любом состоянии без кликов по UI
<Tabs defaultValue="reviews" /> // начальное значение
<Dialog open onOpenChange={fn} /> // controlled
<OrdersTable orders={orders} sort={{ by: "date", dir: "desc" }} onSortChange={fn} />Это же облегчает Storybook-истории: каждое состояние задаётся props.
Эффекты — только для синхронизации с внешним миром
// ✗ Эффект для производного состояния: лишний рендер, асинхронность в тестах
const [fullName, setFullName] = useState("");
useEffect(() => setFullName(`${first} ${last}`), [first, last]);
// ✓ Вычисление при рендере — синхронно и просто тестируется
const fullName = `${first} ${last}`;Меньше эффектов — меньше waitFor и предупреждений act в тестах.
Доступная разметка = тестируемая разметка
// ✗ Нужен data-testid, скринридер тоже ничего не поймёт
<div className="icon-btn" onClick={remove}><TrashIcon /></div>
// ✓ getByRole("button", { name: "Удалить «Чайник»" })
<button type="button" aria-label={`Удалить «${title}»`} onClick={remove}><TrashIcon aria-hidden /></button>Server-side: тонкие адаптеры фреймворка
В Next.js: Server Action и страница — тонкие адаптеры (FormData/params → use case → updateTag/redirect), а use case и DAL — обычные функции с явными зависимостями, которые тестируются без фреймворка (см. тему про Next.js).
Что важно помнить
- Трудно тестировать → вероятно, плохой дизайн.
- Логика в чистых функциях и хуках, компонент — тонкий слой.
- Побочные эффекты на границах; зависимости — явно (параметры, провайдеры, порты).
- Controlled-компоненты и начальные значения через props.
- Семантичная разметка делает тесты проще и проверяет доступность.
Мини-шпаргалка
- Логика →
lib/model(unit); данные → хук (MSW); UI → тонкий компонент (RTL/Storybook). fn(input, now)вместоDate.now()внутри.- Порт + фейк для аналитики, платежей, карт.
- Меньше
useEffect— меньше асинхронности в тестах.