用途:面向本地 Web 应用的前端测试与 UI 调试,通过编写原生 Python Playwright 脚本完成验证与自动化操作。
主要能力:验证前端功能、调试 UI 行为、截图、捕获控制台日志;附带辅助脚本 scripts/with_server.py 管理服务器生命周期,支持同时启动多个服务器(如后端与前端)。
使用方式:先运行脚本的 --help 查看用法,不要先读源码,除非确有必要定制。静态 HTML 可直接读取文件以确定选择器;动态 Web 应用若服务器未运行,执行:
python scripts/with_server.py --help
多服务器示例:
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 逻辑,使用 from playwright.sync_api import sync_playwright,以 headless 模式启动 chromium,访问 http://localhost:5173 后必须 page.wait_for_load_state('networkidle') 再检查 DOM。动态应用采用“先侦察后操作”:等待 networkidle、截图或检查 DOM、识别选择器、执行操作。
适用场景:本地前端功能验证、UI 调试、元素发现(按钮、链接、输入框)、local HTML 文件的 file:// 自动化、控制台日志捕获。
限制与最佳实践:动态页面检查 DOM 前必须先等待 networkidle,否则易出错;建议使用描述性选择器(text=、role=、CSS 选择器或 ID)并添加适当等待;脚本应作为黑盒直接调用,避免读入大文件污染上下文;完成后关闭浏览器。具体收费、平台与效果信息暂未提供。