The Complete Production SOP: How to Deploy and Run Playwright Cross-Browser Testing Suite in Autonomous AI Agents

---
name: "playwright-e2e"
description: "Robust end-to-end browser automation, user flow verification, and visual regression screenshots."
dependencies:
  npm:
    - "@playwright/test"
---

# SOP Rules
- Use Web Assertions: expect(locator).toBeVisible()
- Configure playwright.config.ts with trace: 'on-first-retry'
- Forbid global state mutation between parallel test workers

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

export default defineConfig({
  testDir: './tests/e2e',
  fullyParallel: true,
  forbidOnly: !!process.env.CI,
  retries: process.env.CI ? 2 : 0,
  workers: process.env.CI ? 1 : undefined,
  reporter: 'list',
  use: {
    baseURL: process.env.PLAYWRIGHT_TEST_BASE_URL || 'http://localhost:3000',
    trace: 'on-first-retry',
    screenshot: 'only-on-failure',
  },
  projects: [
    { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
    { name: 'firefox', use: { ...devices['Desktop Firefox'] } },
    { name: 'webkit', use: { ...devices['Desktop Safari'] } },
    { name: 'mobile-chrome', use: { ...devices['Pixel 5'] } },
  ],
});

import { test, expect } from '@playwright/test';

test.describe('Authentication and Session Persistence', () => {
  test('should authenticate user and display dashboard across devices', async ({ page }) => {
    await page.goto('/login');
    await page.getByLabel(/email address/i).fill('[email protected]');
    await page.getByLabel(/password/i).fill(process.env.TEST_USER_PASSWORD || 'SecretPassword123!');
    await page.getByRole('button', { name: /sign in/i }).click();

    await expect(page.getByRole('heading', { name: /system dashboard/i })).toBeVisible();
    await expect(page).toHaveURL(/.*dashboard/);
  });
});