Web 应用 Playwright 测试
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/anthropics-skills-webapp-testing。
技能介绍
要解决什么问题
本地前后端一起在跑时,自动化往往卡在两件事:进程起停要自己管,页面还是客户端渲染,一上来就查 DOM 常常拿到半成品树。这个技能要求用原生 Python Playwright 写脚本,把「起服务」和「点页面」分开处理,并强调在动态应用里先等网络安静下来再动手。
技能如何工作
服务生命周期交给 scripts/with_server.py 这类打包脚本:单服务、多服务(例如后端 + 前端)都可以通过命令行参数配置,自动化脚本里只保留 Playwright 逻辑,服务由 helper 自动拉起和回收。使用前应先对脚本执行 --help,把脚本当黑盒调用,避免把大段实现塞进上下文。
核心流程是 Reconnaissance-Then-Action(先侦察后操作):
- 检查已渲染的 DOM,了解当前页面上真实存在的节点
- 从检查结果里确定选择器(
text=、role=、CSS、ID 等) - 用发现的选择器执行点击、输入等操作
实践上建议用 sync_playwright() 写同步脚本,配合 page.wait_for_selector() 或合理的超时;测完关闭浏览器。examples/ 里有常见模式:element_discovery.py(发现按钮、链接、输入框)、static_html_automation.py(file:// 本地 HTML)、console_logging.py(抓取控制台日志)。
适用边界与注意点
- 面向本机 Web 应用与可自动化的浏览器场景,不是替代正式 CI 测试框架的全套方案说明
- 动态 SPA:不要在
networkidle之前就 inspect DOM;应先page.wait_for_load_state('networkidle') - helper 脚本体量大,默认只调不读,只有黑盒不够用再考虑读源码定制
使用场景
- 本地同时起前端与 API 后,要写脚本自动点通注册/登录主路径
- 改完 React 页面后,在起好的 dev server 上先侦察 DOM 再写稳定选择器
- 用 file:// 打开静态 HTML 原型,验证表单提交与链接跳转是否符合预期
- 调试 flaky 用例时,在自动化过程中抓取浏览器控制台日志对照报错
适合人员
- 维护单体或前后端分离仓库、需要在本机反复验证页面的全栈工程师
- 负责内部管理后台的同学,要把固定巡检步骤写成可重复执行的 Playwright 脚本
- 写 Python 的 QA,要把手工点测清单迁到本地 Web 应用的自动化流程里
- 做前端重构时担心选择器漂移、希望用「先侦察后操作」降低脆性测试的开发者