Браузерная проверка фронтенда

Зачем это нужно

Когда задача меняет страницы или стили фронтенда, стадия проверки качества автоматически открывает локальный стенд в браузере, делает скриншот, сохраняет журнал и краткое резюме в папку артефактов задачи. Для задач без фронтенда шаг пропускается тихо. Если на машине нет ни одного браузерного инструмента, шаг пишет короткую заметку и спокойно идёт дальше — отсутствие инструмента никогда не блокирует проверку.

Цепочка выбора инструмента

Встроенный детектор выбирает первый доступный из трёх вариантов: командная строка Playwright, Playwright через MCP, либо браузер, явно указанный оператором через переменную окружения. Если ни одного из трёх нет, в отчёт попадает только одна строка «инструмент не найден».

Видимый и фоновый режимы

• По умолчанию — фоновый прогон, экран не нужен.
• Видимый (мягкий) — оператор просит видимый браузер флагом или прямо в задании. Если на машине есть экран, окно браузера действительно открывается; если экрана нет — в отчёт уходит заметка, и шаг продолжается в фоновом режиме.
• Видимый (строгий) — тот же запрос с более жёстким контрактом: если экрана нет, шаг завершается ошибкой, и оператор должен перезапустить на машине с экраном.

Где лежат артефакты

Каждый прогон пишет в подпапку с меткой времени: datarim/qa/playwright-<идентификатор задачи>/run-<время>/ со скриншотом, опциональным трейсом, общим логом и коротким резюме. Символическая ссылка latest указывает на последний прогон (на файловых системах без поддержки ссылок используется обычное копирование).

Параллельные прогоны

Замок на уровне задачи не даёт двум одновременным прогонам стадии проверки переписать артефакты друг друга. Если стандартного механизма замков на машине нет, замок плавно переходит на запасной механизм через создание директории.

Источник

Контракт поставляется с Datarim v2.8.0.