playwright-e2e

majiayu000 的头像作者 majiayu000

用于前端 UI 更改的可视化 E2E 测试工作流程。修改 Svelte 组件、布局或样式后使用,以验证 UI 是否正确呈现。

📖 中文导读:用于前端 UI 更改的可视化 E2E 测试工作流程。修改 Svelte 组件、布局或样式后使用,以验证 UI 是否正确呈现。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: playwright-e2e description: Visual E2E testing workflow for frontend UI changes. Use after modifying Svelte components, layouts, or styles to verify the UI renders correctly. allowed-tools: Bash, Read, Glob

Playwright E2E Testing

Visual testing workflow for the Strieber chat UI frontend.

When to Use

After making changes to:

  • Svelte components (frontend/src/**/*.svelte)
  • CSS/styles (frontend/src/app.css, Tailwind classes)
  • Layout structure
  • Any visible UI element

Run Tests

docker compose run --rm playwright-test

This builds the production bundle and runs Playwright tests in headless Chromium.

View Screenshots

After tests complete, read the screenshots:

frontend/test-results/screenshots/layout-desktop.png  # 1280x720 desktop view
frontend/test-results/screenshots/layout-mobile.png   # 375x667 mobile view

Use the Read tool on these PNG files to visually verify the UI.

Verification Checklist

  1. Layout renders correctly (sidebar, main area)
  2. Colors/theme applied properly
  3. Responsive behavior works (mobile hides sidebar)
  4. No visual regressions from previous state
  5. Text is readable and properly positioned

Adding New Tests

Create tests in frontend/e2e/<feature>.spec.ts:

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

test('my feature test', async ({ page }) => {
  await page.goto('/');

  // Take screenshot for visual verification
  await page.screenshot({
    path: 'test-results/screenshots/my-feature.png',
    fullPage: true
  });

  // Add assertions
  await expect(page.locator('.my-element')).toBeVisible();
});

Test Locations

  • Config: frontend/playwright.config.ts
  • Tests: frontend/e2e/*.spec.ts
  • Results: frontend/test-results/ (gitignored)