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

Тестируемый код: как проектировать фронтенд под тесты

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

Если код трудно тестировать, обычно проблема не в тестах, а в дизайне кода: всё смешано в одном компоненте, зависимости захардкожены, логика спрятана в эффектах, глобальное состояние меняется откуда угодно. Тестируемый код почти всегда оказывается и более понятным. Принципы: разделять логику и представление (чистые функции и хуки отдельно, компонент — тонкий слой разметки), выделять побочные эффекты на границы (сеть, хранилища, время, случайность — за небольшими модулями или передаются зависимостями), передавать зависимости явно (props, параметры функций, контекст или DI на уровне composition root, а не прямые импорты синглтонов внутри логики), делать компоненты управляемыми снаружи (controlled/uncontrolled, начальные значения через props), использовать семантичную и доступную разметку (тогда getByRole работает «из коробки»), избегать скрытого глобального состояния (фабрики сторов, а не модульные синглтоны с мутациями). Признак хорошего дизайна: для большинства тестов достаточно мокать только сеть и время.

Вопрос

Как писать фронтенд-код так, чтобы его было легко тестировать? Какие признаки плохо тестируемого кода и как их исправить?

Признаки плохо тестируемого кода

ПризнакПочему мешаетИсправление
Логика расчётов внутри JSX и обработчиковПроверить можно только через рендерВынести в чистую функцию
fetch прямо в компонентеНужно мокать глобальный fetchAPI-слой + 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 — меньше асинхронности в тестах.

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

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

Поиск

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