Init

3. 生成 playwright.config.ts

适配检测到的框架：

Next.js:

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', { open: 'never' }],
    ['list'],
  ],
  use: {
    baseURL: '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'] } },
  ],
  webServer: {
    command: 'npm run dev',
    url: 'http://localhost:3000',
    reuseExistingServer: !process.env.CI,
  },
});

React (Vite):

• 将 baseURL 更改为 http://localhost:5173
• 将 webServer.command 更改为 npm run dev

Vue/Nuxt:

• 将 baseURL 更改为 http://localhost:3000
• 将 webServer.command 更改为 npm run dev

Angular:

• 将 baseURL 更改为 http://localhost:4200
• 将 webServer.command 更改为 npm run start

未检测到框架：

• 省略 webServer 块
• 根据用户输入设置 baseURL 或保留为占位符

4. 创建文件夹结构

e2e/
├── fixtures/
│   └── index.ts          # 自定义 fixture
├── pages/
│   └── .gitkeep          # 页面对象模型 (Page object models)
├── test-data/
│   └── .gitkeep          # 测试数据文件
└── example.spec.ts       # 第一个示例测试

5. 生成示例测试

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

test.describe('Homepage', () => {
  test('should load successfully', async ({ page }) => {
    await page.goto('/');
    await expect(page).toHaveTitle(/.+/);
  });

  test('should have visible navigation', async ({ page }) => {
    await page.goto('/');
    await expect(page.getByRole('navigation')).toBeVisible();
  });
});

6. 生成 CI 工作流

如果存在 .github/workflows/，则创建 playwright.yml：