Configuration Helper

The definePlaywrightDrupalConfig() function returns a complete Playwright configuration with sensible defaults for Drupal testing. It wraps Playwright's defineConfig() and applies the following defaults:

Setting	Default
use.baseURL	process.env.DDEV_PRIMARY_URL
fullyParallel	true
workers	Math.max(2, os.cpus().length - 2)
reporter	CI: [['line'], ['html'], ['json', ...]]; Local: [['html', ...], ['list'], ['json', ...]]
globalSetup	Auto-resolved path to this package's global-setup module

Usage

import { definePlaywrightDrupalConfig } from '@lullabot/playwright-drupal/config';
import { devices } from '@playwright/test';

export default definePlaywrightDrupalConfig({
  testDir: './tests',
  forbidOnly: !!process.env.CI,
  retries: process.env.CI ? 2 : 0,
  use: {
    ignoreHTTPSErrors: true,
    trace: 'on-first-retry',
  },
  projects: [
    {
      name: 'chromium',
      use: { ...devices['Desktop Chrome'] },
    },
  ],
});

Overriding Defaults

Plain-object properties are deep-merged with their defaults at every nesting level, so providing use.ignoreHTTPSErrors keeps the default use.baseURL while adding your setting. Non-object properties (including arrays like reporter) replace the default entirely.

If you need full control, you can always use Playwright's defineConfig() directly with the globalSetup path from this package, as described in prior versions of this README.