跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI大前端

WebUI 测试与 Playwright 自动化适配方案

综述由AI生成提供了一套适配 WebUI 测试与 Playwright 自动化的标准化模板体系。包含手工测试用例模板,规范了字段定义与编写逻辑;提供大模型生成 Playwright 用例的提示词模板(基础版与进阶版),支持将手工用例转化为可执行代码;以及业务地图核心信息梳理模板,用于沉淀页面元素、规则及接口依赖。该方案旨在提升自动化测试落地效率,确保大模型生成代码的可执行性与准确性,适用于团队协作与知识库管理。

山野诗人发布于 2026/4/5更新于 2026/5/2329 浏览

可直接复用的标准化模板(适配 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. 操作对象必须是页面实际可见元素(如'【用户名输入框】'而非'【输入框 1】');
  2. 异常场景需单独编写用例(如用户名空/密码错误/账号锁定),不可与正常场景合并;
  3. 边界场景需明确边界值(如密码 6 位最小长度/18 位最大长度)。

模板 2:大模型生成 Playwright 用例提示词模板(Python 版)

分基础版(无业务地图,快速使用)和进阶版(结合业务地图,高通过率),均按明确约束 + 固定格式 + 结果要求设计,大模型生成的代码可直接执行/少量优化,适配 Playwright 原生特性(步骤校验、报告、异常处理)。

版本 1:基础版提示词(无业务地图,1-2 周快速落地)
请你作为资深 WebUI 自动化测试工程师,将提供的标准化手工测试用例转化为**可直接执行的 Python 版 Playwright 自动化用例**,严格遵循以下要求:1. 代码基础:基于 Playwright 最新稳定版,使用 sync_api 同步方式,无需异步代码; 环境初始化:自动完成浏览器启动(Chrome)、页面打开、隐式等待(设置为 5s),用例结束后自动关闭浏览器; 元素定位:优先使用 /name/role,无则使用稳定的 xpath(避免使用易变的 /标签定位); 步骤校验:每个核心操作步骤后添加**元素存在/值校验**(如输入用户名后校验输入框值是否正确),校验失败抛出明确异常; 预期结果:严格按手工用例的预期结果编写断言,断言失败时输出详细失败信息(如); 测试数据:直接使用手工用例中的测试数据,单独定义变量存储(方便后续替换为数据池); 代码结构:清晰分块(环境初始化→测试步骤→断言校验→后置处理→环境销毁),添加关键注释,无冗余代码; 异常处理:对页面加载超时、元素未找到等常见异常做基础捕获,输出异常原因。请直接生成完整可执行代码,无需额外解释,代码末尾无需加执行命令。【待转化的标准化手工测试用例】
2.
3.
id
class
4.
5.
'页面未跳转到首页,当前 URL 为:/login'
6.
7.
8.
# 此处粘贴模板 1 的手工用例完整内容(含所有字段)
版本 2:进阶版提示词(结合业务地图,核心提效)
请你作为资深 WebUI 自动化测试工程师,结合**业务地图核心信息**和**标准化手工测试用例**,生成**可直接执行、单步可优化的 Python 版 Playwright 自动化用例**,严格遵循以下要求:1. 代码基础:基于 Playwright 最新稳定版,使用 sync_api 同步方式,无需异步代码;2. 环境初始化:自动完成浏览器启动(Chrome)、页面打开、隐式等待(设置为 5s),用例结束后自动关闭浏览器;3. 元素定位:**必须严格使用业务地图中定义的元素定位符**,无明确定位符的使用稳定的 xpath(避免使用易变的 class/标签定位);4. 业务规则:严格遵循业务地图中的页面跳转、操作约束、异常处理规则,不得违反业务逻辑;5. 步骤校验:每个核心操作步骤后添加**元素存在/值/状态校验**(如输入用户名后校验输入框值是否正确),校验失败抛出明确异常;6. 预期结果:严格按手工用例的预期结果编写断言,断言失败时输出详细失败信息(如'页面未跳转到首页,当前 URL 为:/login');7. 测试数据:直接使用手工用例中的测试数据,单独定义变量存储(方便后续替换为测试数据池/接口调用);8. 代码结构:清晰分块(环境初始化→测试步骤→断言校验→后置处理→环境销毁),添加关键注释,无冗余代码;9. 异常处理:对页面加载超时、元素未找到、业务异常(如账号锁定)等做捕获,输出异常原因并终止用例;10. 可优化性:核心操作步骤单独封装为小函数(如 login_op(username, password)),方便后续单步智能优化和复用。请直接生成完整可执行代码,无需额外解释,代码末尾无需加执行命令。【业务地图核心信息(所属模块)】# 此处粘贴该用例所属模块的业务地图核心内容(模板 3 的梳理结果,含元素定位、业务规则、页面跳转等)【待转化的标准化手工测试用例】# 此处粘贴模板 1 的手工用例完整内容(含所有字段)

模板 3:业务地图核心信息梳理模板(WebUI 测试专用)

按功能模块维度梳理,一套系统可拆分为多个模块分别填写(如登录模块、订单模块、购物车模块),梳理结果可直接嵌入模板 2 的进阶版提示词,或部署为大模型本地知识库,核心覆盖大模型生成用例所需的所有业务信息,示例为电商登录模块。

业务地图(XX 模块)核心信息梳理表

模块名称:电商系统 - 用户中心 - 登录模块
维护人:测试工程师 XXX
更新时间:202X-XX-XX
版本:V1.0(需求变更时同步更新版本)

梳理维度具体梳理项填写说明示例(登录模块)
1. 功能模块层级父模块/本模块/子模块明确系统模块的上下级关系、联动模块(如登录模块联动用户信息模块)父模块:用户中心;本模块:登录模块;子模块:无;联动模块:用户信息模块、权限管理模块
2. 页面关联关系所属页面/页面 URL/页面跳转规则明确模块对应的所有页面,以及页面间的触发条件 + 跳转结果所属页面:登录页(/login);
跳转规则:
① 登录成功→首页(/index);
② 登录失败→停留在登录页;
③ 点击注册→注册页(/register);
④ 点击忘记密码→密码找回页(/find_pwd)
3. 核心元素信息页面 + 元素名称 + 定位符 + 元素类型 + 操作规则统一元素定位标准(优先 id/name/role),明确元素的可操作类型(输入/点击/选择)和操作约束登录页:
① 用户名输入框:id=username输入框仅支持字母/数字/下划线,最大 20 位;
② 密码输入框:id=password输入框支持大小写 + 数字 + 特殊字符,6-18 位;
③ 登录按钮:id=login_btn按钮需先输入用户名 + 密码才可点击(否则置灰);
④ 错误提示框:class=error_tips文本框失败时自动显示,成功时隐藏
4. 核心业务规则正常规则/异常规则/边界规则覆盖模块所有业务约束,是大模型生成断言和异常处理的关键① 正常规则:账号密码匹配→登录成功并生成登录令牌;
② 异常规则:用户名空/密码空→提示'请输入用户名/密码';账号密码不匹配→提示'账号或密码错误';连续 5 次失败→账号锁定 10 分钟并提示'账号已锁定';
③ 边界规则:密码 6 位(最小)/18 位(最大)→正常登录
5. 测试数据依赖数据类型/数据来源/数据约束明确模块测试所需数据的类型(账号/密码/验证码等)、来源(数据池/接口/固定值)、约束(是否已注册/是否锁定等)① 有效账号:用户数据池
② 无效账号:固定值(如 test_null/123456)未注册/已锁定;
③ 短信验证码:短信接口(http://xxx/api/sms)与手机号绑定,有效期 5 分钟;
④ 测试密码:密码数据池符合 6-18 位、大小写 + 数字 + 特殊字符规则
6. 异常处理规则常见异常场景/处理方式/预期结果覆盖技术异常(网络/页面/接口)和业务异常(账号锁定/验证码过期),明确处理方式① 网络异常:登录时断网→提示'网络异常,请检查网络并重试',保持登录页;
② 页面加载超时:登录页加载超过 10s→抛出'页面加载超时'异常;
③ 验证码过期:使用过期验证码→提示'验证码已过期,请重新获取';
④ 接口超时:登录请求接口响应超过 5s→提示'请求超时,请重试'
7. 接口依赖关系核心接口/接口地址/请求方式/入参出参明确模块依赖的核心后端接口(如登录接口/验证码接口),可选(复杂业务模块必填)登录接口:http://xxx/api/user/login
维护规范(强制)
  1. 需求新增/变更/下线时,需在 24 小时内更新对应模块的业务地图,并同步版本号;
  2. 元素定位符发生变化(如前端修改 id)时,优先更新业务地图,再同步优化自动化用例;
  3. 所有梳理结果同步至团队知识库(如 Confluence/GitHub),确保测试/开发/产品统一认知。

目录

  1. 可直接复用的标准化模板(适配 WebUI 测试+Playwright 方案)
  2. 模板 1:标准化手工测试用例模板(WebUI 专用)
  3. 填写规范补充(强制)
  4. 模板 2:大模型生成 Playwright 用例提示词模板(Python 版)
  5. 版本 1:基础版提示词(无业务地图,1-2 周快速落地)
  6. 版本 2:进阶版提示词(结合业务地图,核心提效)
  7. 模板 3:业务地图核心信息梳理模板(WebUI 测试专用)
  8. 业务地图(XX 模块)核心信息梳理表
  9. 维护规范(强制)
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • LLaMA-Factory 微调 DeepSeek-R1 模型实战指南
  • 2025 年第 27 届中国机器人及人工智能大赛自主巡航实战经验分享
  • C++ STL string 容器基础用法与构造技巧
  • HTTP 状态码详解:从 200 到 500 的常见含义
  • 基于 AIGC 的销讲型直播内容 5 步策划法
  • 基于大模型 API 与 RAG 知识库构建智能客服机器人
  • GitHub 发布 MCP Server 项目最佳实践:架构、安全与自动化部署
  • AI 生成内容水印技术:原理、工具与实践
  • Webots R2023b 安装配置教程
  • VSCode 中关闭 GitHub Copilot 功能的两种方法
  • 2023 电赛 H 题信号分离装置 FPGA 与 STM32 实现方案
  • Linux 下 libwebkit2gtk-4.1-0 安装与使用指南
  • 大模型书单指南:如何快速选择适合你的书籍
  • VRCT 智能翻译工具:解决 VRChat 跨语言交流问题
  • LangChain 消息处理实战:缓存、过滤、合并与流式输出
  • Rust 异步代码的测试与调试实践
  • 基于 Gemini 3 Pro Image 模型的 AI 科研绘图实测:机制图与技术路线图生成
  • 基于 Claude MCP 协议的智能体落地示例
  • Win11 资源管理器增强:QTTabBar 中文优化版安装与配置
  • 硕士论文盲审前降低 AIGC 检测率策略与评委关注点解析

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online