Тестовые данные: фабрики, фикстуры и сиды
На этой странице
Тестам нужны правдоподобные данные: пользователи, товары, заказы. Если создавать их вручную в каждом тесте, тесты становятся длинными, а при добавлении обязательного поля в тип ломаются десятки файлов. Решение — фабрики (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/data | In-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→ удалить.