Beacon/docs/ui_test_usage.md

UI自动化链路使用说明

1. 功能简介

本系统支持通过 Playwright 驱动浏览器，实现 UI 自动化测试。支持两种模式：

• 每个 UI 步骤新开浏览器（默认）
• 多个 UI 步骤复用同一个浏览器（如：第一个步骤登录，后续步骤基于已登录状态继续操作）

2. 主要参数说明

参数名	类型	说明
browser_type	string	浏览器类型（chromium/firefox/webkit）
headless	bool	是否无头模式
user_data	map	登录等用户信息（如有需要）
browser_session_id	string	浏览器会话ID（用于复用，系统自动传递）
test_case_id	string	用例ID
url_path	string	页面路径

3. 复用浏览器的典型用法

假设有两个步骤：

• 步骤1：登录
• 步骤2：添加新条目

只需在用例配置中将两个步骤都设为 RunUiTest，系统会自动在步骤间传递 browser_session_id，实现浏览器复用。无需手动干预。

示例参数（JSON）：

{
  "test_case_id": "login",
  "url_path": "/login",
  "browser_type": "chromium",
  "headless": true,
  "user_data": {"user": "test", "pass": "test"}
}

第二步：

{
  "test_case_id": "add_item",
  "url_path": "/dashboard",
  "browser_type": "chromium",
  "headless": true,
  "user_data": {}
}

4. 工作流结束后

系统会自动关闭最后一个 UI 测试用到的浏览器，无需手动清理。

5. 结果变量

• ${step.步骤ID.screenshot_url}：获取某步骤的截图URL
• ${step.步骤ID.html_report_url}：获取某步骤的HTML报告URL

6. 常见问题

• Q: 如何确保多个步骤复用同一个浏览器？ A: 只要步骤类型为 RunUiTest，系统会自动传递 browser_session_id。
• Q: 需要手动关闭浏览器吗？ A: 不需要，系统会在工作流结束时自动关闭。
• Q: 可以并发多个浏览器会话吗？ A: 支持，每个工作流独立管理自己的 browser_session_id。

7. 参考

• 详细参数传递机制见 docs/activity_parameter_passing.md
• UI 测试用例开发可参考 workers/python/ui_tests.py