Web 应用 Playwright 测试

问题

本地 Web 应用测试通常不是缺框架，而是卡在工程细节：多个服务如何一起启动、端口和进程如何清理、动态渲染后的选择器从哪里找、什么时候检查 DOM 才稳定。若直接把大型辅助脚本读进上下文，或为每个任务手写服务器生命周期，都会让会话变慢并增加错误。

工作方式

这个技能把本地 Web 测试组织成两层：scripts/with_server.py 作为黑盒负责服务器启动和回收，自动化脚本只写 Playwright 同步逻辑。先用 --help 确认用法，再启动单服务或多服务；在脚本中优先使用 sync_playwright()、描述性选择器（text=、role=、CSS、ID）和显式等待（page.wait_for_selector()）。选择器发现采用“侦查—行动”模式：先检查渲染后的 DOM，再根据实际节点确定操作路径。对动态应用，建议先 page.wait_for_load_state('networkidle')，再检查 DOM；examples/ 提供按钮/链接/输入框发现、本地 HTML 自动化和控制台日志捕获等示例。

注意

不要把 scripts/ 当作文档阅读，除非 --help 无法解决问题；测试结束后应关闭浏览器。对于登录态、WebSocket、第三方慢接口或 networkidle 永远不触发的页面，需要改用更具体的元素等待、超时或自定义探针。