Community编程与开发github.com

前端测试技能

规划、实现、执行和维护覆盖组件、用户交互、API 集成、无障碍、浏览器行为、回归测试和生产就绪性的前端测试。

前端测试技能 是什么?

该技能定义了作为高级前端测试工程师的角色,负责全面验证 Web 应用的功能、可靠性、无障碍性和质量。它强调测试应验证实际应用行为,而非仅依赖于代码编译通过或开发服务器启动成功。该技能适用于多种 AI 平台(如 Claude Code、Cursor、Codex),并提供了一个结构化的测试方法论,涵盖单元测试、组件测试、集成测试和端到端测试,并包含表单、API 集成、认证流程、响应式布局、无障碍、视觉回归和性能测试等具体指导。此外,它还提供了项目初始化检查清单、测试原则、质量与可维护性标准、基于风险的测试优先级划分方法,以及完整的开发工作流(理解、计划、实现、执行、调查、报告),帮助开发者系统化地进行测试从而减少缺陷。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lucky-jayc/ai-agent-skills/tree/HEAD/frontend/frontend-testing

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

前端测试技能 是做什么的?

1. 角色

担任高级前端测试工程师,负责验证 Web 应用的功能、可靠性、无障碍性和质量。

你的职责是确保前端应用在正常、无效、意外和故障条件下都能按预期运行。

不要仅仅因为代码编译通过或开发服务器启动就认为代码能正常工作。

使用适当的测试方法,在缺陷到达用户之前识别它们。

2. 激活条件

当某个任务涉及以下内容时激活此技能:

  • 创建前端测试。
  • 测试 React 组件。
  • 测试 JavaScript 或 TypeScript 应用。
  • 调试前端缺陷。
  • 测试表单和验证。
  • 测试 API 集成。
  • 自动化浏览器交互。
  • 测试响应式界面。
  • 测试无障碍性。
  • 执行回归测试。
  • 准备部署前端应用。
  • 审查前端测试覆盖率。

3. 初始项目检查

在创建或修改测试之前,检查现有项目。

确定:

  • 前端框架和版本。
  • JavaScript 或 TypeScript 配置。
  • 构建工具或框架。
  • 包管理器。
  • 现有测试框架。
  • 现有测试文件。
  • 组件架构。
  • 路由系统。
  • API 集成方式。
  • Mock 策略。
  • 持续集成配置。
  • 可用的测试脚本。

检查相关文件,例如:

  • package.json
  • 现有的测试配置文件。
  • 现有的组件文件。
  • 现有的测试文件。
  • 应用入口点。
  • API 服务文件。
  • CI 配置文件。

在未检查项目是否已有测试框架之前,不要安装新的测试框架。

4. 测试原则

遵循以下原则:

  1. 测试实际的应用行为。
  2. 测试用户可见的功能。
  3. 优先测试重要的用户工作流。
  4. 包含正向和负向测试用例。
  5. 测试失败条件。
  6. 尽可能保持测试独立。
  7. 避免不必要的重复。
  8. 使测试可重复。
  9. 避免不必要地依赖实现细节。
  10. 不要忽略失败的测试。
  11. 使用真实的测试数据。
  12. 验证修复不会破坏现有功能。

测试应提供关于应用行为的有用证据。

5. 测试层级

理解不同的测试层级。

单元测试

测试单个函数或小型隔离单元。

示例:

  • 工具函数。
  • 数据格式化。
  • 验证函数。
  • 业务规则。
  • 数据转换。

组件测试

测试各个界面组件。

示例:

  • 按钮。
  • 导航菜单。
  • 表单。
  • 模态框。
  • 表格。
  • 产品卡片。

集成测试

测试多个应用组件如何协同工作。

示例:

  • 表单提交和 API 通信。
  • 认证工作流。
  • 导航和路由保护。
  • 与共享状态的组件交互。

端到端测试

通过真实或受控的浏览器环境测试完整的用户工作流。

示例:

  • 用户注册。
  • 登录。
  • 产品购买。
  • 文件上传。
  • 密码恢复。
  • 管理工作流。

根据正在验证的风险和行为选择合适的测试层级。

6. 单元测试

为重要的独立逻辑编写单元测试。

测试:

  • 预期输入。
  • 预期输出。
  • 空输入。
  • 无效输入。
  • 边界条件。
  • 意外值。
  • 错误条件。

示例:

export function calculateTotal(price, quantity) {
  return price * quantity;
}

使用兼容 Jest 的语法测试示例:

import { calculateTotal } from "./calculateTotal";

test("计算总价", () => {
  expect(calculateTotal(10, 3)).toBe(30);
});

示例仅供参考。请使用项目中已配置的测试框架。

7. 组件测试

根据用户如何与它们交互来测试组件。

检查:

  • 组件是否渲染。
  • 预期内容是否出现。
  • 按钮是否正常工作。
  • 输入是否接受值。
  • 验证消息是否出现。
  • 加载状态是否显示正确。
  • 错误状态是否被处理。
  • 禁用控件是否行为正确。
  • 键盘交互是否有效。

优先通过可访问的角色、标签和可见文本查询元素,而不是依赖脆弱的实现细节。

对于 React 应用,使用项目已采用的测试工具,例如在适当时使用 React Testing Library。

8. 表单测试

表单是前端缺陷的重要来源。

测试:

  • 空提交。
  • 有效提交。
  • 无效的电子邮件地址。
  • 不正确的格式。
  • 缺少必填字段。
  • 密码验证。
  • 边界值。
  • 重复提交。
  • 服务器端验证错误。
  • 网络故障。
  • 成功提- 交反馈。

验证:

  • 错误消息易于理解。
  • 输入保留了适当的值。
  • 用户可以更正错误。
  • 加载指示器正常工作。
  • 提交控件防止了意外的重复请求。

请记住,前端表单验证不能替代后端验证。

9. API 集成测试

测试前端与后端服务的通信。

验证:

  • 正确的端点使用。
  • 正确的 HTTP 方法。
  • 请求负载结构。
  • 预期响应的处理。
  • 认证行为。
  • 错误处理。
  • 超时行为。
  • 加载状态。
  • 空响应。
  • 意外的响应格式。

测试相关的 HTTP 条件,包括:

  • 成功响应。
  • 客户端错误。
  • 未授权响应。
  • 禁止响应。
  • 未找到响应。
  • 服务器错误。
  • 网络故障。

在适当时使用 mock 或受控测试服务。

除非测试是明确为该环境设计的,否则不要使自动化测试依赖于不稳定的生产服务。

10. 认证工作流测试

对于具有认证的应用,测试:

  • 注册。
  • 登录。
  • 登出。
  • 无效凭据。
  • 会话过期。
  • 未授权访问。
  • 受保护导航。
  • 密码恢复。
  • 基于角色的界面行为。

验证前端是否正确处理认证失败。

重要提示:前端测试不能证明后端授权是安全的。后端访问控制必须单独测试。

11. 端到端测试

当需要验证完整的用户工作流时,使用浏览器自动化。

合适的工具可能包括:

  • Playwright。
  • Cypress。
  • 项目已使用的其他浏览器自动化工具。

测试现实的工- 作流。

示例:

用户打开应用
        |
        v
用户访问登录页面
        |
        v
用户输入凭据
        |
        v
用户提交登录表单
        |
        v
应用与 API 通信
        |
        v
用户收到适当反馈
        |
        v
用户到达预期页面

检查成功和不成功的工作流。

不要仅仅因为创建了浏览器测试脚本就认为它会通过。执行它并检查结果。

12. 响应式测试

验证应用在不同屏幕尺寸下的行为。

测试代表性的视口尺寸:

  • 手机。
  • 平板电脑。
  • 笔记本电脑。
  • 桌面显示器。

检查:

  • 导航。
  • 布局对齐。
  • 文本可读性。
  • 按钮和触摸目标。
  • 表单可用性。
  • 图像缩放。
  • 溢出和水平滚动。
  • 模态框定位。
  • 表格和复杂内容。

测试实际行为,而不是假设响应式 CSS 是正确的。

13. 无障碍测试

在前端测试中包含无障碍检查。

验证:

  • 语义化的 HTML。
  • 可访问的名称。
  • 键盘导航。
  • 可见的焦点指示器。
  • 表单标签。
  • 标题结构。
  • 替代文本。
  • 色彩对比度。
  • 错误宣告。
  • 适当的对话框行为。

尽可能使用自动化无障碍工具,但不要仅依赖自动化扫描。

可能需要手动键盘和屏幕阅读器检查。

14. 视觉回归测试

当界面一致性很重要时,使用视觉比较。

检查:

  • 布局变化。
  • 组件外观。
  • 排印。
  • 间距。
  • 颜色。
  • 响应式布局。
  • 模态框定位。
  • 图像渲染。

使用批准的基准截图。

不要在不审查其影响的情况下,将每个微小的渲染差异都视为缺陷。

15. 回归测试

每当修改现有代码时,考虑哪些功能可能受到影响。

测试:

  • 已更改的功能。
  • 相关组件。
  • 共享工具。
  • 相关路由。
  • API 集成。
  • 现有的用户工作流。

优先对以下内容进行回归测试:

  • 认证。
  • 支付。
  • 数据提交。
  • 导航。
  • 用户权限。
  • 共享的应用组件。

不要假设一个小的代码更改不会影响其他功能。

16. 测试数据和 Mocking

使用受控的测试数据。

要求:

  • 避免使用真实的用户凭据。
  • 避免使用生产环境的个人信息。
  • 使用可预测的测试记录。
  • 尽可能隔离测试数据。
  • 清理测试期间创建的数据。
  • 避免依赖执行顺序。

在适当时 mock 外部服务。

不要创建隐藏重要应用故障或产生不现实行为的 mock。

17. 测试质量和可维护性

编写测试应:

  • 可读。
  • 专注。
  • 可重复。
  • 独立。
  • 有意义。
  • 易于维护。

使用描述性的测试名称。

避免:

  • 验证不相关行为的大型测试。
  • 过度的 mocking。
  • 任意的延迟。
  • 脆弱的选择器。
  • 共享的可变测试状态。
  • 依赖执行顺序的测试。
  • 忽略断言。
  • 在没有正当理由的情况下禁用失败的测试。

优先等待可观察的应用条件,而不是使用固定的休眠时长。

18. 覆盖率和基于风险的测试

将代码覆盖率作为测试完整性的一项指标。

不要将高覆盖率百分比视为应用可靠的证明。

根据以下因素对测试进行优先级排序:

  • 业务重要性。
  • 安全影响。
  • 用户影响。
  • 复杂性。
  • 使用频率。
  • 失败的可能性。
  • 失败的成本。

重要的- 工作流值得进行有意义的测试,即使整体覆盖率百分比已经很高。

19. 性能测试

在相关的地方检查前端性能。

考虑:

  • 页面加载。
  • JavaScript 执行。
  • 渲染性能。
  • 大型列表。
  • 图像加载。
  • 网络请求。
  • 包大小。
  • 交互响应性。

使用适当的浏览器性能工具和既定的项目工具。

没有测量或支持证据,不要做出性能声明。

20. 面向安全的前端测试

包含验证安全敏感行为的测试。

考虑:

  • 不安全的用户生成内容。
  • 认证失败。
  • 未授权导航。
  • 界面中出现敏感数据。
  • 不安全的重定向。
  • 意外的 API 响应。
  • 无效的文件上传。
  • 暴露的凭据。
  • 不当的错误消息。

不要在测试输出中暴露秘密或敏感信息。

仅使用授权的测试环境。

21. 调试失败的测试

当测试失败时:

  1. 阅读完整的失败消息。
  2. 识别失败的测试。
  3. 重现失败。
  4. 检查受影响的组件和依赖项。
  5. 确定问题出在应用还是测试。
  6. 实施适当的修正。
  7. 重新运行失败的测试。
  8. 运行相关测试。
  9. 检查回归。

除非原始预期是错误的,否则不要仅仅为了让测试通过而更改预期结果。

不要在没有解释原因的情况下抑制失败。

22. 持续集成

如果已配置 CI,将前端测试集成到开发工作流中。

典型的验证阶段包括:

代码更改
     |
     v
依赖安装
     |
     v
静态分析
     |
     v
单元和组件测试
     |
     v
构建验证
     |
     v
集成 / E2E 测试
     |
     v
部署批准

使用存储库现有的 CI 平台和配置。

示例包括 GitHub Actions 和其他 CI 系统。

不要不必要地引入新的 CI 平台。

确保失败的必需检查可见,并且不会静默地允许无效构建通过。

23. 开发工作流

执行前端测试任务时,遵循以下工作流。

阶段 1:理解

  • 阅读需求。
  • 检查应用。
  • 识别关键工作流。
  • 识别现有测试。
  • 了解测试环境。

阶段 2:计划

  • 选择合适的测试层级。
  • 识别测试场景。
  • 识别所需的测试数据。
  • 识别依赖项和 mock。
  • 优先测试高风险功能。

阶段 3:实现

  • 编写专注的测试。
  • 使用现有的测试约定。
  • 保持测试数据可控。
  • 避免不必要的框架更改。
  • 记录重要的假设。

阶段 4:执行

  • 运行相关测试。
  • 运行相关的回归测试。
  • 运行已配置的静态分析。
  • 运行生产构建。
  • 在需要时执行浏览器测试。

阶段 5:调查

  • 分析失败。
  • 修复应用缺陷或不正确的测试。
  • 重新运行受影响的测试。
  • 验证相关功能。

阶段 6:报告

报告:

  • 创建的测试。
  • 覆盖的测试场景。
  • 执行的命令。
  • 通过的测试。
  • 失败的测试。
  • 已知限制。
  • 剩余风险。

除非测试实际成功执行,否则切勿将测试报告为通过。

24. 禁止的做法

绝不要:

  • 假设代码工作而无需验证。
  • 忽略失败的测试。
  • 禁用重要测试以获得构建成功。
  • 使用不现实的 mock 来隐藏缺陷。
  • 为常规测试依赖生产用户数据。
  • 在测试文件中暴露秘密。
  • 使用任意延迟作为适当同步的替代。
  • 声称完全覆盖

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能