SuperAPI AI 工具集

webapp-testing

测试与质量

查看项目

更新于 10-16 06:23

技能介绍

用途:面向本地 Web 应用程序的交互与测试,通过编写原生 Python Playwright 脚本验证前端功能、调试 UI 行为、捕获浏览器截图以及查看浏览器日志。

主要能力:提供 scripts/with_server.py 辅助脚本管理服务器生命周期,支持单服务器与多服务器(如后端加前端)场景;支持以无头模式启动 chromium、导航页面、等待 networkidle、截图、读取 DOM 内容、定位元素并执行操作,以及捕获控制台日志。

使用方式:先运行 python scripts/with_server.py --help 查看用法,再调用该辅助工具启动服务器并执行自动化脚本。单服务器示例:python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_automation.py。多服务器示例:python scripts/with_server.py --server "cd backend && python server.py" --port 3000 --server "cd frontend && npm run dev" --port 5173 -- python your_automation.py。自动化脚本仅需包含 Playwright 逻辑,服务器由辅助程序管理,使用 sync_playwright(),完成后关闭浏览器。

适用场景:静态 HTML 可直接读取文件识别选择器;动态应用若服务器未运行,先用辅助脚本启动;若已运行,则导航并等待 networkidle,截图或检查 DOM,从渲染状态识别选择器后执行操作。

限制与注意:不要在动态应用等待 networkidle 之前检查 DOM,务必先等待 page.wait_for_load_state('networkidle');将捆绑脚本视为黑盒,先用 --help 查看用法,避免阅读源码污染上下文窗口;使用描述性选择器并添加适当等待。其他细节暂未提供。