Анатомия хорошего теста: 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, debounce | vi.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для таблицы примеров.