可直接复用的标准化模板(适配 WebUI 测试+Playwright 方案)
模板均按结构化、可落地、适配大模型转化设计,支持直接复制到 Excel/Markdown/团队知识库中使用,贴合团队当前 Playwright 方案的实施需求,同时衔接业务地图提效逻辑。
模板 1:标准化手工测试用例模板(WebUI 专用)
核心适配大模型转化自动化用例,严格遵循操作对象 + 动作 + 值的编写规范,字段覆盖测试执行全要素,支持按功能模块归类管理,示例为电商登录模块,可直接替换业务内容。
| 字段名 | 填写要求/说明 | 示例(账号密码登录) |
|---|---|---|
| 用例唯一 ID | 模块_功能_场景_序号(全局唯一,方便检索) | user_login_pwd_001 |
| 所属功能模块 | 按系统业务地图的模块层级填写(如 XX 系统 - 用户中心 - 登录模块) | 电商系统 - 用户中心 - 登录模块 |
| 用例优先级 | P0(核心必测)/P1(重要功能)/P2(一般功能)/P3(边缘场景) | P0 |
| 测试场景类型 | 正常场景/异常场景/边界场景 | 正常场景 |
| 前置条件 | 量化、明确环境/页面/数据状态(避免模糊描述) | 1. 测试环境已部署,网络正常;2. 测试账号 test123 已注册且未锁定;3. 处于系统登录页(URL:/login) |
| 测试数据 | 明确数据类型/来源/值(如数据池/固定值/接口生成) | 用户名:test123(测试数据池);密码:123456Abc(测试数据池) |
| 操作步骤 | 按步骤序号 + 操作对象 + 操作动作 + 操作值编写,单步骤仅一个核心动作 | 1. 点击【用户名输入框】,输入值 test123;2. 点击【密码输入框】,输入值 123456Abc;3. 点击【登录按钮】(红色,位于输入框下方) |
| 预期结果 | 量化、可判定(含页面跳转/元素显示/数据状态,避免'正常显示') | 1. 页面跳转到系统首页(URL:/index);2. 首页右上角显示用户名'test123';3. 浏览器 Cookie 中生成有效登录令牌 |
| 后置处理 | 用例执行后恢复环境/数据状态(如退出登录/清除缓存,可选) | 点击【退出按钮】,退出当前账号登录 |
| 备注 | 特殊说明(如依赖其他用例/需特定环境,可选) | 无 |
填写规范补充(强制)
- 操作对象必须是页面实际可见元素(如'【用户名输入框】'而非'【输入框 1】');
- 异常场景需单独编写用例(如用户名空/密码错误/账号锁定),不可与正常场景合并;
- 边界场景需明确边界值(如密码 6 位最小长度/18 位最大长度)。
模板 2:大模型生成 Playwright 用例提示词模板(Python 版)
分基础版(无业务地图,快速使用)和进阶版(结合业务地图,高通过率),均按明确约束 + 固定格式 + 结果要求设计,大模型生成的代码可直接执行/少量优化,适配 Playwright 原生特性(步骤校验、报告、异常处理)。
版本 1:基础版提示词(无业务地图,1-2 周快速落地)
请你作为资深 WebUI 自动化测试工程师,将提供的标准化手工测试用例转化为**可直接执行的 Python 版 Playwright 自动化用例**,严格遵循以下要求:1. 代码基础:基于 Playwright 最新稳定版,使用 sync_api 同步方式,无需异步代码; 环境初始化:自动完成浏览器启动(Chrome)、页面打开、隐式等待(设置为 5s),用例结束后自动关闭浏览器; 元素定位:优先使用 /name/role,无则使用稳定的 xpath(避免使用易变的 /标签定位); 步骤校验:每个核心操作步骤后添加**元素存在/值校验**(如输入用户名后校验输入框值是否正确),校验失败抛出明确异常; 预期结果:严格按手工用例的预期结果编写断言,断言失败时输出详细失败信息(如); 测试数据:直接使用手工用例中的测试数据,单独定义变量存储(方便后续替换为数据池); 代码结构:清晰分块(环境初始化→测试步骤→断言校验→后置处理→环境销毁),添加关键注释,无冗余代码; 异常处理:对页面加载超时、元素未找到等常见异常做基础捕获,输出异常原因。请直接生成完整可执行代码,无需额外解释,代码末尾无需加执行命令。【待转化的标准化手工测试用例】

