webapp-testing

webapp-testing 技能为软件代理程序提供了一个结构化的框架，用于对本地网页应用程序执行端到端测试和侦察。通过运用 Playwright，它实现了对浏览器实例的程序化控制，非常适合开发人员、质量保证工程师以及需要验证前端组件或在开发环境中调试 UI 行为的 AI 代理。该技能旨在处理现代网页堆栈的复杂性，包括动态渲染、网络同步和多服务器编排。

• 使用 Python Playwright 进行自动化浏览器编排，包括无头模式执行以提高效率。

• 本地开发服务器的生命周期管理，支持具有多个后端和前端服务的复杂设置。

• 可视化调试与 DOM 检查功能，包括全页截图和内容提取，用于选择器识别。

• 内置支持“网络空闲 (networkidle)”等待模式，确保与 JavaScript 重度框架交互时的可靠性。

• 控制台日志捕获与分析，用于在自动化序列中排查执行时错误。

• 在编写自订自动化逻辑之前，请务必先查看辅助脚本的说明文档，以避免重复工作。

• 在处理动态网页应用程序时，请务必等待 'networkidle' 状态，确保在检查或交互之前 DOM 已完全渲染。

• 使用基于角色、基于文字或 CSS ID 的特定选择器来编写稳健的测试脚本；避免依赖脆弱的 XPath。

• 使用随附的 'scripts/with_server.py' 工具来管理服务器生命周期，这有助于防止悬空进程并确保环境状态一致。

• 将提供的辅助脚本视为黑盒工具，以尽量减少上下文窗口的占用；仅在绝对需要进行自订调试时才读取原始代码。

• 适用于自动化视觉回归测试、验证表单交互、验证用户流程以及一般前端组件评估等案例。