playwright.config.ts

import { defineConfig, devices } from '@playwright/test';

/**
 * E2E config for the in-place menu editor.
 *
 * Targets the wp-env *tests* instance (port 8889 by default), whose default admin login is
 * admin / password. The `setup` project (tests/e2e/auth.setup.ts) logs in once and
 * stores the session so specs start authenticated; every spec depends on it.
 */
const testsPort = process.env.WP_ENV_TESTS_PORT || '8889';

export default defineConfig( {
	testDir: './tests/e2e',
	timeout: 30_000,
	expect: { timeout: 10_000 },
	fullyParallel: false,
	// Serialize across spec files. The plugin's entire state is ONE shared
	// WordPress option (maestro_config) on a single wp-env instance; fixtures.ts
	// wipes it before every test for isolation. That per-test reset is a
	// destructive `option delete` — under concurrent workers it could land mid-
	// test in another spec file (e.g. delete the option between a save and its
	// reload-assert), creating a fresh cross-file race. workers:1 makes the
	// shared-option reset race-free; it is the precondition for true isolation
	// here, not a flake mask. (fullyParallel:false alone only serializes WITHIN
	// a file — separate files still run on separate workers.)
	workers: 1,
	// CI absorbs genuine flakes (network/timing races in wp-env) with two
	// retries; local runs stay strict at zero so a real break surfaces
	// immediately. `trace: 'on-first-retry'` captures a trace when a retry kicks
	// in, so a flaky failure is still diagnosable.
	retries: process.env.CI ? 2 : 0,
	reporter: 'list',
	use: {
		baseURL: `http://localhost:${ testsPort }`,
		trace: 'on-first-retry',
	},
	projects: [
		// Runs first (every spec depends on it) and unauthenticated — it is what
		// creates the stored session. Shares chromium's device profile so the
		// context that generates the session matches the one that consumes it;
		// storageState lives on the chromium project only, so this logs in fresh.
		{ name: 'setup', testMatch: /auth\.setup\.ts/, use: { ...devices['Desktop Chrome'] } },
		{
			name: 'chromium',
			dependencies: [ 'setup' ],
			use: {
				...devices['Desktop Chrome'],
				storageState: './tests/e2e/.auth/admin.json',
			},
		},
	],
} );