SuperAPI AI 工具集

playwright

测试与质量

查看项目

更新于 10-15 17:17

技能介绍

用途:为 Web 应用生成并运行 Playwright 端到端测试,覆盖测试编写、执行与调试流程。

前置检查:npx playwright --version。未安装时用 npm init playwright@latest,或在已有项目中执行 npm install -D @playwright/test && npx playwright install。

工作流:先阅读待测页面或组件的源码,理解路由、交互元素与预期行为;再按项目既有模式与目录结构创建测试文件,使用 import { test, expect } from '@playwright/test' 及 test.describe、test.beforeEach、test 结构组织用例;随后运行测试,常用命令包括 npx playwright test <file> 运行指定文件、--headed 显示浏览器、--ui 进入 UI 模式、--trace on 采集追踪。

调试:仔细阅读错误输出;用 npx playwright show-trace trace.zip 打开追踪查看器;失败时可用 await page.screenshot({ path: 'debug.png' }) 截图;在 headed 模式下用 page.pause() 逐步调试。

能力:导航与 URL 断言、重定向验证;表单填充、下拉选择、勾选及多步向导;断言如 expect(page).toHaveURL()、expect(locator).toBeVisible()、toHaveText();整页与元素级截图;结合阈值的视觉回归 expect(page).toHaveScreenshot();借助 @axe-core/playwright、ARIA 角色选择器和键盘导航做无障碍测试;用 page.route() 模拟网络、page.waitForResponse() 等待接口。

使用建议:优先使用 data-testid 属性作为稳定选择器,优先用户可见文本与 ARIA 角色而非 CSS 选择器;复杂多步流程用 test.step();在 playwright.config.ts 设置 baseURL;异步导航用 page.waitForResponse();测试文件放入项目既有的测试目录模式中。

限制:资料未提供具体价格、平台支持范围及性能效果说明。