Amiga
Оглавление курса · урок 8 из 13

Модуль 2 · Автоматизация · урок 8 из 13

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

Половина нестабильных тестов ломается из-за данных: два параллельных теста правят одну запись, тест зависит от того, что оставил предыдущий, на стенде кто-то удалил нужную страницу. Если не объяснить агенту правила, он сделает только хуже и охотно захардкодит test@test.ru в двадцати местах. Ниже о том, как навести порядок и поручить агенту рутину.

Правила для данных

Запишите их в AGENTS.md, и агент будет следовать им в каждом новом тесте:

markdown · AGENTS.md
### Тестовые данные

- Каждый тест создаёт свои данные и не зависит от других тестов и порядка запуска.
- Уникальность: в имена и email добавляется идентификатор воркера и время,
  домен — example.test.
- Созданное в тесте удаляется в его же фикстуре после выполнения.
- Общие справочные данные — только из сидов проекта; править их в тесте запрещено.
- Реальные персональные данные (дампы прода, выгрузки CRM) в тестах и в чате с агентом запрещены.

Домен .test зарезервирован для тестирования и никогда не станет настоящим, так что письмо на такой адрес не уйдёт живому человеку, даже если отправка где-то не отключена.

Фикстуры Playwright

Фикстура в Playwright — функция, которая готовит данные до теста и убирает их после. Попросите агента вынести повторяющуюся подготовку из спеков в фикстуру:

typescript · tests/e2e/fixtures/lead.ts
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 и получает готовые данные:

typescript · tests/e2e/lead-form.spec.ts
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 данные готовят фабрики моделей, а справочники заполняют сиды. Хорошая задача для агента — пройтись по тестам и найти повторяющуюся ручную подготовку:

text
Найди в tests/ места, где модели создаются вручную с заполнением всех
полей. Предложи фабрики для этих моделей с минимальными валидными
значениями и состояниями (например, «опубликованная», «черновик»).
Перепиши два самых длинных теста на фабрики. Поведение тестов не меняй;
прогони их до и после и приложи оба вывода.

Прогон «до и после» показывает, что рефакторинг не изменил того, что тесты проверяют.

Генерация наборов данных

Агент быстро готовит наборы для граничных проверок: строки максимальной длины, имена с дефисами и апострофами, адреса с юникодом, телефоны в разных форматах. Просите его сразу помечать, зачем нужно каждое значение:

text
Сгенерируй JSON-набор для проверки поля «Имя»: по 3 значения на каждый
класс — валидные, пустые, на границе длины 100 и 101, со спецсимволами,
с эмодзи, с HTML-тегами (как текст). У каждого значения: value, class,
expected ("accept" | "reject"), причина.

Такой набор можно подключить к параметризованному тесту, а на ревью будет видно, почему каждое значение там оказалось.

Персональные данные

Самая опасная ошибка с данными — дать агенту реальные. Дамп продовой базы, выгрузка из CRM или список клиентов в промпте означают передачу персональных данных во внешний сервис. Правило курса простое: агенту можно давать только синтетику и сиды. Если для воспроизведения бага нужна структура реальных данных, сначала обезличьте их скриптом. Такой скрипт агент напишет быстро, но проверяете его вы. Просмотрите результат и поищите оставшиеся email, телефоны и имена в свободных текстовых полях: комментариях, адресах, заметках менеджеров.

Попробуйте сами

10–15 мин на рабочем месте
  1. Добавьте в AGENTS.md раздел о тестовых данных и попросите агента найти в существующих спеках захардкоженные email и телефоны.
  2. Вынесите подготовку данных одного спека в фикстуру с уборкой. Запустите тест два раза подряд и параллельно в нескольких воркерах (--workers=4 --repeat-each=3): данные не должны конфликтовать.
  3. Сгенерируйте с агентом набор граничных значений для одного поля и подключите его к параметризованному тесту.

Коротко

  • Каждый тест создаёт свои уникальные данные и убирает их за собой, домен — example.test.
  • Фикстуры Playwright выносят подготовку и уборку из спеков; способ уборки один и описан в AGENTS.md.
  • Вход выполняется один раз через storageState, файлы состояния в git не попадают.
  • Фабрики и сиды на бэкенде агент предлагает хорошо, но прогон «до и после» обязателен.
  • Реальные персональные данные агенту не передаются, только синтетика и обезличенные выборки.
Отметка хранится только в вашем браузере
Хотите связаться с владельцем
компании напрямую?
Дмитрий Тарасов
Дмитрий Тарасов
СЕО

НАПИСАТЬ

Написать в MAX