用途:该技能面向 QA 自动化工程师,指导使用 Playwright 内置的 APIRequestContext(而非外部 HTTP 库)编写、审查和调试 API 测试,用于 RESTful 服务校验、认证流程与 API 契约验证。
主要能力:强调类型安全(为请求/响应载荷定义 TypeScript 接口)、测试隔离(每个测试自建数据并清理)、全面校验(状态码、请求头、响应体结构与耗时),以及可复用抽象(按服务域构建 API 客户端类)。提供项目结构建议(tests/api、fixtures、models、clients、utils 与 playwright.config.ts),以及 BaseApiClient、领域客户端、自定义 fixture(如 usersApi、productsApi、authToken)的写法。
典型测试场景:CRUD 操作、认证(登录成功/失败、携带 Bearer token 访问受保护端点、无效 token 返回 401)、错误与校验(400、409、404)、分页与过滤、响应头校验(content-type、安全头等)、响应时间断言;进阶模式含并行隔离测试、带认证的自定义请求上下文、multipart 文件上传。
使用方式:配置 testDir、reporter,设置 baseURL 与 extraHTTPHeaders;通过 fixture 复用登录逻辑;用环境变量管理 URL 与凭据。
最佳实践:使用唯一测试数据、测试后清理、校验响应 schema、覆盖正常与异常路径、检查响应时间与幂等性、按版本组织测试;避免测试依赖链、硬编码 ID、只验状态码、混用 UI 与 API 测试、忽略限流与边界载荷等反模式。
限制:资料未提供安装命令、版本要求、收费信息或实际执行环境说明。