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

Анатомия хорошего теста: AAA, именование, изоляция, детерминизм

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

Хороший тест читается как спецификация и падает только по делу. Структура AAA — Arrange (подготовить данные и окружение), Act (выполнить одно действие), Assert (проверить результат); в BDD-стиле то же называют Given/When/Then. Имя теста описывает поведение и условие: «показывает ошибку, если email без @», а не «test 3». Свойства хорошего теста: изолированный (не зависит от других тестов и порядка запуска — каждый готовит свои данные и убирает за собой), детерминированный (одинаковый результат при каждом прогоне: никаких реальных таймеров, Date.now(), случайностей и настоящей сети), быстрый, сфокусированный (одна причина падения), понятный при падении (сообщение сразу говорит, что не так). Избегай логики в тестах (if, циклы с вычислениями), «магических» данных без смысла и чрезмерного DRY: в тестах ясность важнее отсутствия повторов. Хороший тест можно сломать — проверь, что он краснеет, если сломать код.

Вопрос

Как выглядит хорошо написанный тест? Что такое паттерн AAA и какие свойства должны быть у теста?

AAA

import { describe, it, expect } from "vitest";
import { calculateTotal } from "./cart";
 
describe("calculateTotal", () => {
  it("применяет процентную скидку промокода к сумме без доставки", () => {
    // Arrange
    const items = [{ price: 1000, qty: 2 }, { price: 500, qty: 1 }];
    const promo = { type: "percent", value: 10 } as const;
 
    // Act
    const total = calculateTotal({ items, promo, delivery: 300 });
 
    // Assert
    expect(total).toBe(2250 + 300); // (2500 − 10%) + доставка
  });
});

Пустые строки между блоками достаточно; комментарии // Arrange полезны новичкам и в длинных тестах.

Именование

✗ Плохо✓ Хорошо
test("works")it("возвращает 0 для пустой корзины")
test("button")it("блокирует кнопку отправки, пока форма невалидна")
test("error case")it("показывает «Промокод не найден», если сервер ответил 404")

Шаблон: «[что делает] [при каком условии]». describe группирует по единице (компонент, функция) или сценарию:

describe("<LoginForm />", () => {
  describe("когда сервер отвечает 401", () => {
    it("показывает сообщение о неверном пароле", async () => { /* … */ });
    it("оставляет введённый email", async () => { /* … */ });
  });
});

Свойства хорошего теста (FIRST)

СвойствоЗначениеКак обеспечить
FastБыстрыйМок сети, без реальных задержек, меньше e2e
IsolatedНезависимыйСвои данные в каждом тесте, сброс моков и стора, нет общего мутабельного состояния
RepeatableДетерминированныйФейковые таймеры, фиксированная дата, сиды для случайности, MSW
Self-validatingСам говорит «прошёл/упал»Утверждения, а не console.log и ручная проверка
TimelyВовремяПишется вместе с кодом

Источники недетерминизма

// ✗ Зависит от текущей даты — упадёт 1 января или в другом часовом поясе
expect(formatRelative(order.createdAt)).toBe("вчера");
 
// ✓ Фиксируем время
vi.useFakeTimers();
vi.setSystemTime(new Date("2026-03-15T12:00:00Z"));
expect(formatRelative("2026-03-14T12:00:00Z")).toBe("вчера");
vi.useRealTimers();
ИсточникРешение
Date.now(), new Date()vi.setSystemTime
setTimeout, debouncevi.useFakeTimers + vi.advanceTimersByTime
Math.random, crypto.randomUUIDПередавать генератор зависимостью или vi.spyOn
Реальная сетьMSW
Часовой пояс и локальTZ=UTC в конфиге, явная локаль в Intl
Порядок тестовСброс состояния в beforeEach/afterEach
АнимацииОтключить или prefers-reduced-motion

Не перебарщивай с DRY

// ✗ Тест не читается без прыжков по файлу
it("case 3", () => runScenario(SCENARIOS[3]));
 
// ✓ Фабрика убирает шум, но важные для теста значения видны в самом тесте
it("не даёт оформить заказ, если товара нет в наличии", async () => {
  const product = buildProduct({ stock: 0 });   // ключевое условие — на виду
  renderProductPage(product);
  expect(screen.getByRole("button", { name: "В корзину" })).toBeDisabled();
});

Правило: DAMP, а не DRY (Descriptive And Meaningful Phrases) — в тестах повторение допустимо ради ясности.

Без логики в тестах

// ✗ Тест повторяет логику кода — ошибку он не поймает
expect(getDiscount(price)).toBe(price > 1000 ? price * 0.1 : 0);
 
// ✓ Конкретные примеры, включая границы
it.each([
  [999, 0],
  [1000, 0],
  [1001, 100.1],
])("для цены %i скидка %d", (price, discount) => {
  expect(getDiscount(price)).toBeCloseTo(discount);
});

Проверь, что тест умеет падать

Написал тест и он сразу зелёный? Временно сломай код (или утверждение) и убедись, что тест краснеет с понятным сообщением. Частая ошибка — асинхронное утверждение без await, которое никогда не выполняется.

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

  • AAA: подготовка → одно действие → проверка.
  • Имя теста — поведение и условие.
  • Изолированность и детерминизм: время, таймеры, случайность, сеть, локаль под контролем.
  • DAMP важнее DRY; без логики в тестах.
  • Убедись, что тест может упасть.

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

  • Arrange / Act / Assert = Given / When / Then.
  • «делает X, когда Y».
  • FIRST: Fast, Isolated, Repeatable, Self-validating, Timely.
  • vi.setSystemTime, vi.useFakeTimers, MSW, TZ=UTC.
  • it.each для таблицы примеров.

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

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

Поиск

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