64 lines
2.4 KiB
Markdown
64 lines
2.4 KiB
Markdown
# 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）**：
|
||
```json
|
||
{
|
||
"test_case_id": "login",
|
||
"url_path": "/login",
|
||
"browser_type": "chromium",
|
||
"headless": true,
|
||
"user_data": {"user": "test", "pass": "test"}
|
||
}
|
||
```
|
||
|
||
第二步：
|
||
```json
|
||
{
|
||
"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` |