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

Тестовые данные: фабрики, фикстуры и сиды

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

Тестам нужны правдоподобные данные: пользователи, товары, заказы. Если создавать их вручную в каждом тесте, тесты становятся длинными, а при добавлении обязательного поля в тип ломаются десятки файлов. Решение — фабрики (builders): функция buildOrder(overrides) возвращает валидный объект по умолчанию, а тест переопределяет только то, что важно для этого сценария (buildOrder({ status: "cancelled" })) — ключевое условие видно прямо в тесте. Фабрики типизируются моделью или схемой API, используют счётчик или faker для уникальных значений (с фиксированным сидом для воспроизводимости) и умеют строить связи (buildOrder с buildUser). Фикстуры — заранее подготовленные наборы данных или окружение (JSON-ответы, файлы, фикстуры Playwright). Сиды — наполнение тестовой БД для интеграционных и e2e-тестов. Принципы: минимум данных, явные значимые поля, уникальность (параллельные тесты не конфликтуют), независимость тестов от общих мутабельных данных.

Вопрос

Как организовать тестовые данные, чтобы тесты были короткими, понятными и не ломались при изменении моделей?

Проблема ручных данных

// ✗ Каждый тест повторяет 15 полей; что здесь важно для теста — непонятно
const order = {
  id: "1", number: "A-1", status: "cancelled", total: 1000, currency: "RUB",
  items: [{ id: "i1", title: "Чайник", price: 1000, qty: 1 }],
  customer: { id: "u1", name: "Анна", email: "a@b.ru" },
  createdAt: "2026-01-01T00:00:00Z", deliveryAddress: { /* … */ },
};

Фабрика

// src/test/factories/order.ts
import type { Order, OrderItem } from "@/entities/order";
import { buildUser } from "./user";
 
let seq = 0;
const nextId = (prefix: string) => `${prefix}-${++seq}`;
 
export function buildOrderItem(overrides: Partial<OrderItem> = {}): OrderItem {
  return { id: nextId("item"), title: "Чайник", price: 1000, qty: 1, ...overrides };
}
 
export function buildOrder(overrides: Partial<Order> = {}): Order {
  const items = overrides.items ?? [buildOrderItem()];
  return {
    id: nextId("order"),
    status: "pending",
    items,
    total: items.reduce((s, i) => s + i.price * i.qty, 0),
    currency: "RUB",
    customer: buildUser(),
    createdAt: "2026-01-15T10:00:00Z",
    ...overrides,
  };
}
// ✓ В тесте видно главное
it("не показывает кнопку отмены для отменённого заказа", () => {
  renderWithProviders(<OrderCard order={buildOrder({ status: "cancelled" })} />);
  expect(screen.queryByRole("button", { name: "Отменить" })).not.toBeInTheDocument();
});

Добавили в Order обязательное поле — правим одну фабрику, а TypeScript покажет, где её нужно обновить.

Библиотеки

ИнструментДля чего
Своя функция buildXЧаще всего достаточно
fisheryФабрики с последовательностями, ассоциациями, трейтами (orderFactory.cancelled().build())
@faker-js/fakerРеалистичные имена, адреса, тексты, даты
zod-mock / генерация из OpenAPIОбъекты по схеме
@mswjs/dataIn-memory модели для MSW с запросами и связями
import { Factory } from "fishery";
import { faker } from "@faker-js/faker";
 
faker.seed(42);                          // воспроизводимые «случайные» данные
 
export const userFactory = Factory.define<User>(({ sequence }) => ({
  id: `user-${sequence}`,
  name: faker.person.fullName(),
  email: `user${sequence}@example.com`,  // уникально и предсказуемо
  role: "user",
}));
 
const admin = userFactory.build({ role: "admin" });
const users = userFactory.buildList(3);

Осторожно со случайностью: если тест зависит от случайного значения (длина имени влияет на вёрстку), он станет нестабильным. Значимые поля задавай явно.

Фикстуры-файлы

src/test/fixtures/
├── orders.response.json      ← реальный ответ API (обезличенный) для маппера
├── avatar.png                ← файл для теста загрузки
└── large-catalog.json        ← 1000 товаров для теста виртуализации
import ordersResponse from "@/test/fixtures/orders.response.json";
it("маппер разбирает реальный ответ API", () => {
  expect(() => ordersResponse.map(toOrder)).not.toThrow();
});

Фикстуры из реальных ответов полезны для мапперов и контрактов, но их легко забыть обновить — генерация из схемы надёжнее.

Данные для e2e и интеграции с БД

ПодходКак
Сид перед прогономСкрипт pnpm db:seed:test заполняет базовые справочники
Данные на тест через APIТест создаёт свои сущности через API/фабрику (request.post("/api/test/users"))
Транзакция с откатомКаждый интеграционный тест в транзакции, которая откатывается
Уникальные значенияemail: user-${randomUUID()}@example.com — параллельные тесты не конфликтуют
ОчисткаУдаление созданного в afterEach или изолированная БД/схема на воркер
// Playwright: фикстура создаёт пользователя через тестовый API
export const test = base.extend<{ customer: { email: string; password: string } }>({
  customer: async ({ request }, use) => {
    const customer = { email: `e2e-${crypto.randomUUID()}@example.com`, password: "Test_Password_123" };
    await request.post("/api/test/users", { data: customer });
    await use(customer);
    await request.delete(`/api/test/users/${customer.email}`);
  },
});

Тестовые эндпоинты (/api/test/*) доступны только в тестовом окружении — проверяй это флагом и не выкатывай в продакшен.

Анти-паттерны

Анти-паттернПочему плохо
Общий мутабельный объект для всех тестовОдин тест меняет его — падает другой
«Мистический гость» — данные в далёком файле без явной связи с проверкойНепонятно, почему тест ожидает «3»
Один огромный сид «на все случаи»Тесты зависят друг от друга через данные
Копия продакшен-базыПерсональные данные, огромный размер, нестабильность
Случайные значения в значимых поляхНестабильные тесты

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

  • Фабрика возвращает валидный объект; тест переопределяет только значимое.
  • Типизация фабрик ловит изменения моделей.
  • Faker — с фиксированным сидом; значимые поля — явно.
  • Для e2e: тест создаёт свои данные с уникальными значениями и убирает их.
  • Не делить мутабельные данные между тестами.

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

  • buildX(overrides) + счётчик для id.
  • fishery: Factory.define, build, buildList, трейты.
  • faker.seed(42).
  • Фикстура Playwright: создать → use → удалить.

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

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

Поиск

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