用途:测试本地 Web 应用,通过编写原生 Python Playwright 脚本完成自动化操作与验证。
主要能力:附带 scripts/with_server.py 辅助脚本,用于管理服务器生命周期,支持同时启动多个服务器(如后端 + 前端);提供 examples/ 参考示例,包括元素发现(按钮、链接、输入)、静态 HTML 自动化(file:// URL)和控制台日志捕获。
使用方式:先运行脚本的 --help 查看用法,不要直接阅读源码,脚本体积较大且会污染上下文窗口,应作为黑盒直接调用。动态应用若服务器未运行,先执行 python scripts/with_server.py --help,再结合辅助脚本编写简化的 Playwright 脚本。单服务器示例: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(),始终以无头模式启动 chromium,操作完成后关闭浏览器。动态应用应先导航并等待 networkidle,再截图或检查 DOM,从渲染结果中识别选择器后执行操作。
适用场景:本地 Web 应用的端到端测试、界面元素发现、自动化交互与验证。
限制:静态 HTML 可直接读取文件识别选择器,失败或不完整时按动态应用处理;动态应用检查 DOM 前必须先等待 networkidle。选择器应具有描述性(text=、role=、CSS 选择器或 ID),并按需添加等待。其余平台、收费等信息暂未提供。