Terminal
Terminal/Skill
Sets up Playwright browser tests for App Builder single-page apps and AEM extension UIs, including CI runs.
By Adobe
Works with
npx skills add adobe/skills --skill appbuilder-e2e-testingPlaywright-based browser E2E testing for Adobe App Builder SPAs and AEM extensions. This skill generates Playwright configs, test files, and CI workflows for browser-level validation.
Identify the user's intent, then read the referenced sections to generate tailored tests.
| User wants | Reference | Asset |
|---|---|---|
| E2E test for ExC Shell SPA | references/e2e-testing-patterns.md | assets/playwright.config.ts, assets/e2e-test-template.spec.ts |
| Test AEM extension in browser | references/aem-extension-testing.md | assets/playwright.config.ts |
| E2E tests in CI pipeline | references/ci-integration.md | assets/e2e-ci-workflow.yml |
When the user says "add E2E tests" or "write Playwright tests" and intent is clear:
web-src/ (SPA) or @adobe/uix-guest in dependencies (AEM extension)npm install -D @playwright/test && npx playwright install chromiumplaywright.config.ts from assets/playwright.config.tsreferences/e2e-testing-patterns.md, generate test with iframe navigation, shell wait, Spectrum ARIA selectorsreferences/aem-extension-testing.md, generate test with Extension Tester URL, nested iframe handling, modal flowsnpx playwright testassets/e2e-ci-workflow.ymle2e/ at project root (separate from Jest test/)playwright.config.ts at project rootnpm install -D @playwright/test && npx playwright install chromium (installs Playwright + Chromium browser)npx playwright test (headless) or npx playwright test --headed (visible browser)npx playwright test --debug (step-through mode)npx playwright show-report (open HTML report)page.frameLocator('iframe') — exact selector varies, see references/e2e-testing-patterns.mdgetByRole('button', { name: 'Save' }), getByRole('grid'), getByRole('textbox')aio app dev (local) first. See references/e2e-testing-patterns.md § Authentication.devMode=true. See references/aem-extension-testing.md.web-src/ (SPA), @adobe/uix-guest (AEM extension), existing test setup, app.config.yaml extension typenpm install -D @playwright/test && npx playwright install chromium if not already installedassets/playwright.config.ts for the projectreferences/e2e-testing-patterns.mdreferences/aem-extension-testing.mdpage.route() interceptsnpx playwright test, fix selectors/timing as neededreferences/ci-integration.md and generate workflow from assets/e2e-ci-workflow.ymlplaywright.config.ts configured for the projecte2e/ directorygetByRole, getByLabel) — no CSS class selectorsframeLocator() — no frame() with indexawait expect() assertions — no assertion-free testspage.route() for deterministic resultspage.waitForTimeout() — use waitForSelector, waitForResponse, or Playwright auto-waitingreferences/e2e-testing-patterns.md for Playwright E2E patterns for ExC Shell SPAs (iframe nav, Spectrum selectors, auth, action stubbing).references/aem-extension-testing.md for AEM extension testing patterns (Extension Tester, nested iframes, modal lifecycle, extension points).references/ci-integration.md for running Playwright in GitHub Actions (browser install, artifact upload, headless config).assets/playwright.config.ts as the base Playwright configuration template.assets/e2e-ci-workflow.yml as the GitHub Actions workflow template for E2E tests.page.frameLocator('iframe[src*="your-app"]') or discover with page.frames().runtime.done() is called in the SPA. For E2E, wait for content inside the iframe rather than the shell itself.getByRole() instead of CSS selectors. Check references/e2e-testing-patterns.md § Spectrum Selectors.aio app dev) which skips shell auth. See auth section in references/e2e-testing-patterns.md.references/aem-extension-testing.md § Common Gotchas.retries: 1), use waitForResponse() for action calls, and check references/ci-integration.md for headless configuration.appbuilder-ui-scaffolder (after UI components are generated, add E2E tests)appbuilder-testing (when user wants browser-level validation beyond Jest unit tests)appbuilder-cicd-pipeline (add E2E test job to CI/CD pipeline)