playwright

Playwright E2E Testing Skill

Purpose

Write and maintain end-to-end tests that verify critical user journeys, accessibility compliance, and cross-browser behavior using Playwright.

Locator Priority

Use accessible locators in this order:

1. page.getByRole() — semantic role + accessible name
2. page.getByLabel() — form controls by label
3. page.getByText() — visible text content
4. page.getByPlaceholder() — input placeholders
5. page.getByTestId() — last resort for complex selectors

Best Practices

• Test critical user journeys, not individual components.
• Configure retries for CI (retries: 2).
• Capture screenshots on failure.
• Never hard-code sleeps/timeouts; rely on Playwright auto-waiting.
• Run against production build when possible.

Running Tests

task test:e2e
task test:e2e:headed
task test:e2e:install