Playwright testing packages

This monorepo publishes two packages:

• @lullabot/playwright-drupal integrates Playwright with Drupal and DDEV. It creates isolated SQLite sites, runs Drush commands against the current test site, captures PHP and browser errors, and applies Drupal defaults to the shared screenshot and accessibility helpers.
• @lullabot/playwright-testing contains framework-neutral accessibility, screenshot stabilization, visual comparison, and GitHub reporting utilities.

Existing Drupal imports remain supported. The Drupal package depends on and re-exports the generic APIs, while its wrappers apply Drupal-specific axe exclusions, toolbar settling, image recovery, and legacy screenshot thresholds. Non-Drupal projects should install @lullabot/playwright-testing directly.

# Drupal and DDEV integration, including the compatibility API
npm install --save-dev @lullabot/playwright-drupal @playwright/test

# Framework-neutral utilities
npm install --save-dev @lullabot/playwright-testing @playwright/test

For Drupal setup, database fixtures, and DDEV workflows, visit the playwright-drupal documentation. The generic package has canonical guides for accessibility testing, screenshots and visual comparisons, and GitHub reporting.

Development

Run these commands from the repository root for both packages:

npm ci
npm run lint
npm run format:check

Use npm run lint:fix to apply automatic lint fixes and npm run format to format JavaScript and TypeScript. ESLint uses the upstream recommended configs, and Prettier uses its default formatting, including semicolons and double quotes. CI checks both. Build output and bundled agent tooling are excluded. The lint config allows existing any types and fields omitted with rest destructuring; other recommended rules retain their defaults.

Both packages require @playwright/test as a peer dependency (Playwright 1.50.0 or newer within 1.x). Install the runner in the consumer project so both helpers use its exact instance. Upgrade Playwright there; do not install a separate runner inside either helper. The minimum covers screenshot stylePath (1.41) and the updateSnapshots: "changed" mode used by accessibility baselines (1.50).