cc-1c-skills/tests/web-test

Регресс-тесты web-test

E2E-тесты движка web-test (Playwright + изолированная синтетическая БД 1С), запускаются через node .claude/skills/web-test/scripts/run.mjs test.

Запуск

# Полный регресс (все 21 тестов)
node .claude/skills/web-test/scripts/run.mjs test tests/web-test/

# Один файл
node .claude/skills/web-test/scripts/run.mjs test tests/web-test/02-crud.test.mjs

# Несколько файлов (позиционные = пути к тестам, можно сколько угодно)
node .claude/skills/web-test/scripts/run.mjs test tests/web-test/04-selectvalue.test.mjs tests/web-test/11-report.test.mjs

# Несколько по фильтру тегов
node .claude/skills/web-test/scripts/run.mjs test tests/web-test/ --tags=table,smoke

# По regex имени теста
node .claude/skills/web-test/scripts/run.mjs test tests/web-test/ --grep=multi

URL не передаём позиционно — берётся из webtest.config.mjs (contexts.a.url = http://localhost:9191/webtest-runner/ru_RU). Переопределить можно флагом --url=<url>.

Exit code: 0 = все прошли, 1 = есть падения.

CLI флаги runner'а

Флаг	Описание
--url=URL	Переопределить базовый URL (по умолчанию — из webtest.config.mjs)
--tags=A,B	Запустить только тесты с одним из тегов
--grep=regex	Фильтр по имени теста
--bail	Остановиться на первой ошибке
--retry=N	Перепрогон упавших тестов N раз
--timeout=ms	Таймаут одного теста (default 30000)
--report=path	Сохранить машинный отчёт в файл
--report=-	Машинный отчёт в stdout (прогресс → stderr)
--format=json|allure|junit	Формат отчёта
--report-dir=path	Корень для Allure/JUnit артефактов
--screenshot=on-failure|every-step|off	Когда снимать скриншоты
--record	Включить запись MP4 (CDP screencast → ffmpeg)

Опции стенда (после --)

_hooks.mjs поднимает изолированный стенд (Apache на :9191, своя БД, отдельный набор EPF). По умолчанию работает в smart-режиме: пересборка только когда поменялся config-hash / epf-hash. Принудительно — через флаги после --:

# Принудительно пересобрать XML + БД + EPF
node .claude/skills/web-test/scripts/run.mjs test tests/web-test/ -- --rebuild-stand

# Точечно — только пересобрать БД из существующего XML (свежая синтетика)
node .claude/skills/web-test/scripts/run.mjs test tests/web-test/ -- --reload-data

# Только пересобрать XML (когда хочется новой конфигурации)
node .claude/skills/web-test/scripts/run.mjs test tests/web-test/ -- --rebuild-config

# Только EPF (внешние обработки для openFile)
node .claude/skills/web-test/scripts/run.mjs test tests/web-test/ -- --rebuild-epf

Флаг	Что делает
--rebuild-stand	Эквивалент всех трёх ниже
--rebuild-config	XML-исходники + БД
--reload-data	Только БД (drop+create+load+update)
--rebuild-epf	Только EPF-обработки

Когда пересобирать стенд

Warm-старт (~200 ms): lockfile + probe Apache, БД жива, EPF на диске — ничего не делаем.

Триггеры авто-пересборки (без флагов):

• Изменился config-hash синтетической XML — пересобирается конфигурация + БД.
• Изменился epf-hash исходников EPF — пересобираются EPF.

Когда нужен --rebuild-stand вручную:

• БД накопила «мусорных» данных от write-сценариев. 15-multi-context-handover создаёт нового Контрагента каждый прогон с unique-именем — со временем 02-crud начнёт падать (Контрагент ООО Север уезжает за maxRows=20).
• Подозрение что Apache держит зависший процесс — --rebuild-stand делает web-stop + web-publish.

Конфигурация

tests/web-test/webtest.config.mjs задаёт:

• contexts.a / contexts.b — два независимых 1C-сеанса (разные cookies) на той же URL. Тесты с multi-context тегом используют оба.
• defaultContext: 'a' — большинство тестов работают в одном контексте.
• isolation: 'tab' — вкладки в одном окне (default). Альтернатива 'window' — отдельный BrowserContext (полная изоляция cookies).

Env переменные

Переменная	Значение
WEB_TEST_PRESERVE_CLIPBOARD=0	Отключить save/restore буфера обмена вокруг pasteText
WEBTEST_HOOKS_RUNTIME=python	Использовать py-версии скиллов вместо ps1 (для не-Windows)

Артефакты

• tests/web-test/error-*.png — скриншоты упавших шагов (auto на --screenshot=on-failure)
• tests/web-test/_allure/ — Allure-результаты (на --format=allure)
• tests/skills/.cache/webtest-stand/ — lockfiles стенда (config-hash, epf-hash, data-hash)

Известные нюансы

• 15-multi-context-handover создаёт unique-Контрагента и сохраняет — за серию прогонов накапливаются «лишние» записи. Если 02-crud начал падать на «ООО Север должен быть в списке» — это симптом, лечится -- --rebuild-stand.
• 04-selectvalue auto-history шаг — в изоляции делает warm-up через двойной selectValue('Менеджер', 'ООО Юг') чтобы наполнить history, иначе первый вызов идёт через method:form, а тест ожидает method:dropdown. Не зависит от других файлов.
• Скриншот ошибки только на последнем падении — --screenshot=on-failure (default) делает один кадр в момент исключения. Для full-trace используй --screenshot=every-step.