End-to-End Testing with Playwright¶
Status: 🟢 Active | Owner: Engineering Enablement
Playwright Configuration¶
// playwright.config.ts
import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
testDir: './e2e',
fullyParallel: true,
forbidOnly: !!process.env.CI,
retries: process.env.CI ? 2 : 0,
workers: process.env.CI ? 1 : undefined,
reporter: [['html'], ['github']],
use: {
baseURL: process.env.BASE_URL ?? 'http://localhost:3000',
trace: 'on-first-retry',
screenshot: 'only-on-failure',
video: 'retain-on-failure',
},
projects: [
{ name: 'chromium', use: { ...devices['Desktop Chrome'] } },
{ name: 'firefox', use: { ...devices['Desktop Firefox'] } },
],
});
Test Fixtures¶
Use Playwright fixtures for shared setup and page objects:
// e2e/fixtures/index.ts
import { test as base } from '@playwright/test';
import { LoginPage } from '../pages/login.page';
import { CheckoutPage } from '../pages/checkout.page';
type Fixtures = {
loginPage: LoginPage;
checkoutPage: CheckoutPage;
authenticatedPage: Page;
};
export const test = base.extend<Fixtures>({
loginPage: async ({ page }, use) => {
await use(new LoginPage(page));
},
authenticatedPage: async ({ page, loginPage }, use) => {
await loginPage.goto();
await loginPage.loginAs(testUsers.standard);
await use(page);
},
});
export { expect } from '@playwright/test';
See E2E Testing Standards for Page Object Model and selector standards.
Last reviewed: 2025-Q4 | Owner: Engineering Enablement