mirror of
https://github.com/Nikolay-Shirokov/cc-1c-skills.git
synced 2026-07-18 08:39:40 +03:00
Nick Shirokov
3f1168b975
Раннер регресса теперь держит пул 1С-сеансов сам, вместо накопления контекстов
между тестами и ручного закрытия в хуках. Три необязательных поля webtest.config.mjs
(без них поведение прежнее):
- maxContexts — потолок одновременно живых сеансов (null = без лимита);
- contextPolicy — 'reuse' (держать открытыми в пределах лимита) | 'strict'
(закрывать non-pinned контексты теста сразу после него);
- pinnedContexts — не вытесняются LRU (default = [defaultContext]; [] делает
default вытесняемым на тесном стенде).
Перед setup каждого теста LRU-вытеснение освобождает слот под нужды теста;
уже открытые нужные контексты переиспользуются. Default больше не вечно-pinned.
Исчерпание пула даёт внятную ошибку вместо маскирующего «Browser not connected».
- new: cli/test-runner/context-pool.mjs — чистый планировщик planEviction + LRU.
- cli/commands/test.mjs (v1.4): парсинг/валидация полей, вытеснение с фолбэк-парковкой
на нужный контекст (нельзя закрыть единственный активный), strict-закрытие, LRU-трекинг.
- Доки: regression-spec (§7/§8/глоссарий), regression-guide (рецепт), regress.md.
- Регресс дай-фудит фичу: 14-multi-context-routing роутит в 3-й контекст c,
15-multi-context-handover проверяет вытеснение c на границе; конфиг maxContexts:2.
Юнит-краёв планировщика — в debug/ (gitignored). Live-регресс: 25/25 зелёных.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Регресс-тесты 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/contexts.c— независимые 1C-сеансы (разные cookies) на той же URL.a,b— два «пользователя» мультиконтекст-тестов;cзадействован только14-multi-context-routingи служит топливом для проверки вытеснения пула.defaultContext: 'a'— большинство тестов работают в одном контексте.isolation: 'tab'— вкладки в одном окне (default). Альтернатива'window'— отдельный BrowserContext (полная изоляция cookies).maxContexts: 2/contextPolicy: 'reuse'/pinnedContexts: []— дай-фуд управления пулом лицензий. Лимит 2 одновременных сеанса: на границе14 (c) → 15 (a,b)раннер автоматически вытесняет LRU-контекстc(проверяется первым шагом15-multi-context-handover). Благодаря лимиту 3 контекста никогда не живут одновременно.
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-selectvalueauto-history шаг — в изоляции делает warm-up через двойнойselectValue('Менеджер', 'ООО Юг')чтобы наполнить history, иначе первый вызов идёт черезmethod:form, а тест ожидаетmethod:dropdown. Не зависит от других файлов.- Скриншот ошибки только на последнем падении —
--screenshot=on-failure(default) делает один кадр в момент исключения. Для full-trace используй--screenshot=every-step.