Skip to content

test(e2e): add shared harness and testing guide - #201

Open
khaliulin wants to merge 4 commits into
mainfrom
test/component-harness
Open

khaliulin wants to merge 4 commits into
mainfrom
test/component-harness

Conversation

@khaliulin

@khaliulin khaliulin commented Nov 20, 2026 •

Copy link
Copy Markdown
Contributor

Сводка

Добавляет общий e2e-харнесс, 52 спеки компонентов и страницу документации «Начало работы → Тестирование». Теперь проверки запускаются одной командой и в CI, а не живут только локально.

Изменения

  1. Перенесены раннеры e2e/check.mjs, run.mjs, all.mjs, storybook-runner.mjs, builtin-all.mjs и lib/*.
  2. Добавлены 52 e2e-спеки в e2e/specs, генератор smoke-спек и реестр компонентов.
  3. Закоммичен .storybook/test-runner.ts со стилевыми, a11y- и пиксельными снимками.
  4. Добавлены devDependencies playwright, axe-playwright, jest-image-snapshot и npm-скрипты test:component, test:e2e, test:e2e:builtin.
  5. Добавлен CI workflow .github/workflows/component-tests.yml.
  6. Добавлена docs-страница src/stories/Testing.mdx и раздел проверки в GettingStarted.mdx.

Изменения API

Изменений API нет.

Технические заметки для ревьюеров

  • Baseline не коммитится: первый прогон создаёт его, CI кэширует между запусками.
  • image-спека не входит: компонент появится после мержа PR feat(image): add ExtraImage component and preview toolbar #200.
  • button-спека сгенерирована как smoke под текущий main; глубокие сценарии добавит компонентный PR.
  • Docs использует только поддерживаемую Storybook-разметку: без таблиц, task-list и сырого HTML.
  • e2e/registry.json, отчёты, артефакты и baseline исключены через .gitignore.

Визуальные изменения

В Storybook появляется страница «Начало работы → Тестирование» и блок проверки компонента в Getting Started.

Проверка

  • node e2e/all.mjs --theme=light: 52 спеки, падений нет.
  • node e2e/builtin-all.mjs на чистых baseline: 52/52 компонентов.
  • component-tests в CI: pass (24m29s) до добавления docs; после добавления docs запущен повторно.
  • Docs-страница проверена в Storybook: рендерится без ошибок, все секции на месте.
  • Не проверялось: полный npm ci на чистой машине.

Известные проблемы и открытые вопросы

  • image.e2e.mjs добавим после мержа PR feat(image): add ExtraImage component and preview toolbar #200.
  • CI идёт около 24 минут: builtin-матрица последовательная, есть запас до таймаута 25 минут.
  • Нужно решить, хранить ли baseline в репозитории или только в кэше CI.

Стек

База: main (e30e5304). PR #202 закрыт и схлопнут сюда.

1. Перенести в репозиторий e2e-раннеры, проверку компонента и 52 спеки.
2. Добавить конфиг Storybook test-runner, devDependencies и npm-скрипты.
3. Добавить CI с прогоном builtin-матрицы и e2e.

Заметки для ревьюеров:
- image-спека не входит: компонент появится после мержа PR #200.
- Baseline не коммитится: CI создаёт его первым прогоном и кэширует.
Danil Khaliulin added 3 commits November 20, 2026 19:15
1. Передавать updateSnapshot=new, чтобы первый прогон в CI записывал новые снимки, а существующие сравнивал.

Заметки для ревьюеров:

- Без этого CI падал на avatar, badge, card, chip, divider, skeleton и tag.
1. Создавать отсутствующий PNG вручную и сравнивать уже с ним: jest-image-snapshot не пишет новые снимки в CI.

Заметки для ревьюеров:

- Это устраняет падения avatar, badge, card, chip, divider, skeleton и tag в CI.
1. Добавить страницу «Начало работы/Тестирование»: роли встроенного test-runner и e2e, запуск одной командой, отчёты и коды возврата.
2. Добавить в Getting Started раздел проверки компонента перед PR.

Заметки для ревьюеров:
- Только документация Storybook; e2e-харнесс локальный и в коммит не входит.
@khaliulin khaliulin changed the title test(e2e): add shared component test harness test(e2e): add shared harness and testing guide Nov 20, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant