网页应用测试工具

技能简介

基于Playwright的本地网页应用测试工具包，支持前端功能验证、UI行为调试、浏览器截图和日志查看。

能做什么

• 编写Python脚本自动操作浏览器
• 管理多服务器生命周期（前后端同时启动）
• 捕获页面截图用于排查问题
• 记录浏览器控制台日志
• 识别动态渲染后的DOM元素

使用说明

安装依赖：需预先安装Python 3.x及Playwright库

pip install playwright
playwright install chromium

基础用法：

1. 首次使用任何脚本时，先运行--help查看参数
2. 单服务器场景：python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_script.py
3. 多服务器场景：重复添加--server和--port参数
4. 脚本中始终使用sync_playwright()，启动chromium时设置headless=True
5. 访问页面后必须调用page.wait_for_load_state('networkidle')等待JS执行完成

侦察-行动模式：对动态应用，先截图或获取HTML分析元素，再编写具体操作逻辑。

输入与输出

见下方输入与输出表格。

风险提示

• 未等待networkidle直接操作DOM会导致元素查找失败
• 避免直接阅读scripts/目录下的源码，通过–help使用黑盒调用
• headless模式部分CSS渲染可能与桌面浏览器存在差异
• 多服务器启动时需确保端口不冲突

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/seanphan/webapp-testing/SKILL.md
来源类型：GitHub仓库