SuperAPI AI 工具集

playwright-api

编程与开发

查看项目

更新于 10-16 03:47

技能介绍

用途:该技能面向 QA 自动化工程师,指导使用 Playwright 内置的 APIRequestContext(而非外部 HTTP 库)编写、审查和调试 API 测试,覆盖 RESTful 接口验证、认证流程与接口契约校验。

主要能力:

  • 用 APIRequestContext 发起 GET/POST/PUT/PATCH/DELETE 请求,校验状态码、响应头、响应体结构与响应时间。
  • 以 TypeScript 接口定义请求/响应负载,保证类型安全。
  • 通过领域 API 客户端类(BaseApiClient 及 UsersApiClient 等)封装可复用请求逻辑。
  • 用自定义 fixture 提供 usersApi、productsApi、authToken 等,避免重复登录逻辑。
  • 支持认证测试(登录、无效凭据 401、Bearer token、过期/无效 token)、错误与校验测试(400、409、404)、分页与过滤、响应头与响应时间断言。
  • 覆盖并行隔离测试、带认证的自定义请求上下文、通过 multipart 的文件上传等进阶模式。

使用方式:项目按 tests/api、fixtures、models、clients、utils 组织;在 playwright.config.ts 中配置 testDir、baseURL(如 process.env.API_BASE_URL || 'http://localhost:3000/api')、extraHTTPHeaders 与 html/json 报告器。测试示例中通过 expect(response.status()).toBe(201) 等断言状态码,并通过 await response.json() 解析响应体。

适用场景:RESTful 服务接口测试、认证与授权流程验证、CRUD 生命周期校验、接口契约与错误处理验证。

限制与最佳实践:资料要求使用唯一测试数据、测试后清理、验证响应 schema、覆盖正常与异常路径、避免硬编码 URL 与凭据、按资源或功能分组测试、用 fixture 处理认证、校验幂等性与限流;应避免测试依赖链、硬编码 ID、仅校验状态码、跳过错误场景、混合 UI 与 API 测试等反模式。资料未提供具体安装命令、版本要求或收费信息。