此文件通过 Web 特有的测试内容扩展了 common/testing.md。

Web 测试规则¶

优先级¶

1. 视觉回归¶

• 在主要断点处截图：320、768、1024、1440
• 测试英雄区域、滚动叙事区域以及有意义的状态
• 对于视觉密集型工作，使用 Playwright 截图
• 如果存在两种主题，则测试两者

2. 可访问性¶

• 运行自动可访问性检查
• 测试键盘导航
• 验证减少动态效果的行为
• 验证颜色对比度

3. 性能¶

• 对重要页面运行 Lighthouse 或等效工具
• 保持 performance.md 中的 CWV 目标

4. 跨浏览器¶

• 最低要求：Chrome、Firefox、Safari
• 测试滚动、动效和回退行为

5. 响应式¶

• 在 320、375、768、1024、1440、1920 下测试
• 验证没有溢出
• 验证触摸交互

E2E 格式¶

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

test('landing hero loads', async ({ page }) => {
  await page.goto('/');
  await expect(page.locator('h1')).toBeVisible();
});

• 避免不稳定的基于超时的断言
• 优先使用确定性等待

单元测试¶

• 测试工具函数、数据转换和自定义 Hook
• 对于高度视觉化的组件，视觉回归通常比脆弱的标记断言提供更高的信号
• 视觉回归是对覆盖率目标的补充，而非替代