Модуль 2 · Автоматизация · урок 8 из 13
Тестовые данные и фикстуры
Половина нестабильных тестов ломается из-за данных: два параллельных теста правят одну запись, тест зависит от того, что оставил предыдущий, на стенде кто-то удалил нужную страницу. Если не объяснить агенту правила, он сделает только хуже и охотно захардкодит test@test.ru в двадцати местах. Ниже о том, как навести порядок и поручить агенту рутину.
Правила для данных
Запишите их в AGENTS.md, и агент будет следовать им в каждом новом тесте:
### Тестовые данные
- Каждый тест создаёт свои данные и не зависит от других тестов и порядка запуска.
- Уникальность: в имена и email добавляется идентификатор воркера и время,
домен — example.test.
- Созданное в тесте удаляется в его же фикстуре после выполнения.
- Общие справочные данные — только из сидов проекта; править их в тесте запрещено.
- Реальные персональные данные (дампы прода, выгрузки CRM) в тестах и в чате с агентом запрещены.Домен .test зарезервирован для тестирования и никогда не станет настоящим, так что письмо на такой адрес не уйдёт живому человеку, даже если отправка где-то не отключена.
Фикстуры Playwright
Фикстура в Playwright — функция, которая готовит данные до теста и убирает их после. Попросите агента вынести повторяющуюся подготовку из спеков в фикстуру:
import { test as base, expect } from '@playwright/test';
type Lead = { name: string; email: string; phone: string };
export const test = base.extend<{ lead: Lead }>({
lead: async ({ request }, use, testInfo) => {
const id = `${testInfo.workerIndex}-${Date.now()}`;
const lead: Lead = {
name: `Тест ${id}`,
email: `qa+${id}@example.test`,
phone: '+79990000000',
};
await use(lead);
// уборка: тестовый эндпоинт доступен только на локальном стенде
await request.delete(`/test-api/leads?email=${encodeURIComponent(lead.email)}`);
},
});
export { expect };Спек импортирует test из фикстуры вместо @playwright/test и получает готовые данные:
import { test, expect } from './fixtures/lead';
test('заявка с уникальными данными попадает в список', async ({ page, lead }) => {
await page.goto('/contacts');
await page.getByLabel('Имя').fill(lead.name);
await page.getByLabel('Email').fill(lead.email);
await page.getByRole('button', { name: 'Отправить' }).click();
await expect(page.getByText('Спасибо, заявка отправлена')).toBeVisible();
});Эндпоинт уборки в примере условный: в вашем проекте это может быть служебный маршрут, доступный только при локальном окружении, команда artisan или прямой запрос в тестовую базу. Главное, чтобы способ был один и был описан в AGENTS.md, иначе агент будет изобретать новый в каждом тесте.
Авторизация без повторного логина
Если тесты работают под пользователем, логиниться в каждом из них долго, да и нестабильно. В Playwright принято входить один раз в отдельном проекте настройки и сохранять состояние браузера через storageState, а остальные проекты подключают его через dependencies. Попросите агента настроить это по документации Playwright и проверить, что тесты под разными ролями используют разные файлы состояния. Сами файлы состояния добавьте в .gitignore, потому что в них лежат куки сессии.
Учётные данные тестовых пользователей берите из сидов или переменных окружения стенда. Брать их из чата с агентом или из личных аккаунтов нельзя.
Сиды и фабрики на бэкенде
В юнит- и интеграционных тестах на Laravel данные готовят фабрики моделей, а справочники заполняют сиды. Хорошая задача для агента — пройтись по тестам и найти повторяющуюся ручную подготовку:
Найди в tests/ места, где модели создаются вручную с заполнением всех
полей. Предложи фабрики для этих моделей с минимальными валидными
значениями и состояниями (например, «опубликованная», «черновик»).
Перепиши два самых длинных теста на фабрики. Поведение тестов не меняй;
прогони их до и после и приложи оба вывода.Прогон «до и после» показывает, что рефакторинг не изменил того, что тесты проверяют.
Генерация наборов данных
Агент быстро готовит наборы для граничных проверок: строки максимальной длины, имена с дефисами и апострофами, адреса с юникодом, телефоны в разных форматах. Просите его сразу помечать, зачем нужно каждое значение:
Сгенерируй JSON-набор для проверки поля «Имя»: по 3 значения на каждый
класс — валидные, пустые, на границе длины 100 и 101, со спецсимволами,
с эмодзи, с HTML-тегами (как текст). У каждого значения: value, class,
expected ("accept" | "reject"), причина.Такой набор можно подключить к параметризованному тесту, а на ревью будет видно, почему каждое значение там оказалось.
Персональные данные
Самая опасная ошибка с данными — дать агенту реальные. Дамп продовой базы, выгрузка из CRM или список клиентов в промпте означают передачу персональных данных во внешний сервис. Правило курса простое: агенту можно давать только синтетику и сиды. Если для воспроизведения бага нужна структура реальных данных, сначала обезличьте их скриптом. Такой скрипт агент напишет быстро, но проверяете его вы. Просмотрите результат и поищите оставшиеся email, телефоны и имена в свободных текстовых полях: комментариях, адресах, заметках менеджеров.
Попробуйте сами
10–15 мин на рабочем месте- Добавьте в AGENTS.md раздел о тестовых данных и попросите агента найти в существующих спеках захардкоженные email и телефоны.
- Вынесите подготовку данных одного спека в фикстуру с уборкой. Запустите тест два раза подряд и параллельно в нескольких воркерах (
--workers=4 --repeat-each=3): данные не должны конфликтовать. - Сгенерируйте с агентом набор граничных значений для одного поля и подключите его к параметризованному тесту.
Коротко
- Каждый тест создаёт свои уникальные данные и убирает их за собой, домен —
example.test. - Фикстуры Playwright выносят подготовку и уборку из спеков; способ уборки один и описан в AGENTS.md.
- Вход выполняется один раз через
storageState, файлы состояния в git не попадают. - Фабрики и сиды на бэкенде агент предлагает хорошо, но прогон «до и после» обязателен.
- Реальные персональные данные агенту не передаются, только синтетика и обезличенные выборки.