appbuilder-e2e-testing

Этот официальный skill Adobe предназначен для браузерных end-to-end проверок приложений Adobe App Builder с Playwright. Его область — именно пользовательские сценарии в браузере: ExC Shell SPA, интерфейсы расширений AEM и full-stack flows. Для Jest-тестов действий или React-компонентов в описании предусмотрен другой путь, поэтому карточка не смешивает unit-проверки с E2E-проверками. Практический результат workflow — конфигурация Playwright, тестовые файлы в каталоге e2e и, если это требуется проекту, CI-workflow. Сначала skill предлагает определить форму приложения и имеющуюся тестовую инфраструктуру. Для SPA проверяется каталог web-src/, для AEM extension — наличие @adobe/uix-guest в зависимостях; также учитывается тип extension в app.config.yaml. Эта разведка нужна, чтобы выбрать правильный шаблон, а не применять одну конфигурацию ко всем проектам. Затем уточняется scope: какие страницы или flows проверяются, запускать ли тесты локально или на deployed environment и нужна ли интеграция с CI. Если проект не содержит такой структуры, сначала требуется разобраться с самим проектом, а не приписывать ему App Builder-сценарий. Для ExC Shell SPA skill использует навигацию внутри iframe через page.frameLocator('iframe'); точный селектор зависит от приложения. Для AEM extension применяется Extension Tester URL с devMode=true и учитываются вложенные iframe. Spectrum-компоненты рекомендуется искать по доступным ARIA-ролям — например, кнопке, grid или textbox — вместо CSS-классов. В тестах нужны await expect() и содержательные assertions, чтобы проход считался проверкой, а не просто открытием страницы. Для нестабильных backend-ответов предусмотрено детерминирующее перехватывание через page.route(). Быстрый путь включает установку @playwright/test и Chromium, создание playwright.config.ts, генерацию теста из подходящего шаблона и запуск npx playwright test. Для отладки используется режим --debug, для просмотра HTML-отчёта — npx playwright show-report. Если нужен CI, skill предлагает отдельный workflow с headless-запуском и артефактами. Команды рассчитаны на Node.js 18+ и Playwright; исходник также перечисляет npm, npx и aio как разрешённые инструменты. Качество проверяется через ARIA-селекторы, frameLocator вместо обращения к iframe по индексу, assertions в каждом тесте и отсутствие жёстких page.waitForTimeout(). Для ожиданий следует использовать автоматическое ожидание Playwright, waitForSelector или waitForResponse. Установку и запуск лучше начинать локально: для полной auth-автоматизации ExC Shell источник отдельно предупреждает о сложности и предлагает сначала проверить сценарий через aio app dev. При проблемах с iframe, spinner, Spectrum, IMS или flaky CI источник даёт отдельные направления диагностики, но не обещает универсальный селектор или готовую авторизацию для любого App Builder-проекта.