Web 应用测试

用于使用 Playwright 与本地 Web 应用程序交互和测试的工具包。它支持验证前端功能、调试 UI 行为、捕获浏览器截图和查看浏览器日志。该技能提供用于管理服务器生命周期的辅助脚本,并强调有效浏览器自动化的侦察-然后-行动模式。

测试根据应用程序类型遵循决策树:

对于静态 HTML:

• 直接读取 HTML 文件以识别选择器
• 使用发现的选择器编写 Playwright 脚本
• 如果不完整,则视为动态

对于动态 Web 应用:

1. 如果服务器未运行 - 使用 scripts/with_server.py 管理服务器生命周期:

   python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_test.py
   

   支持多个服务器(例如后端 + 前端)

2. 侦察-然后-行动模式:

   • 导航并等待 networkidle(对动态应用至关重要)
   • 截图或检查 DOM
   • 从渲染状态识别选择器
   • 使用发现的选择器执行操作

关键模式:

page.goto('http://localhost:5173')
page.wait_for_load_state('networkidle')  # 等待 JS 执行
page.screenshot(path='/tmp/inspect.png')  # 先检查
# 然后执行操作