web-test-reporter — 网页-test-报告er
v1.0.0网页功能测试自动化执行与报告生成。使用 代理-browser 命令行工具 对 网页 系统进行完备的功能测试,并生成标准 Word (.docx) 测试报告。激活时机:(1) 用户要求测试某个页面或模块的功能,(2) 用户要求生成功能测试报告,(3) 用户要求对 网页 系统做走查/验证/自动化测试。
运行时依赖
安装命令
点击复制技能文档
网页 功能测试规范 启动流程 第一步:询问前后端代码路径
开始测试前,先询问用户是否可以提供前后端项目代码路径:
可以提供代码路径 → 获取前后端代码路径,先通读目标模块代码(见"代码阅读"章节),再进行测试 无法提供代码路径 → 跳过代码阅读,直接按黑盒测试流程执行
第二步:获取前端地址与登录信息 已提供前端地址 + 登录信息 → 直接开始 只提供了前端地址 → 先访问页面判断是否需要登录: 需要登录 → 询问租户(如有)、用户名、密码,获取后登录 不需要登录 → 直接开始 未提供前端地址 → 询问前端地址,再按上述流程处理 代码阅读(有代码路径时必须执行)
拿到代码路径后,先通读再测试,阅读顺序:
前端代码(src/views/<模块>/):
列表页 索引.vue:搜索字段、表格列、操作按钮、分页 表单页 XxxForm.vue:所有字段、必填校验、子表结构、多标签页 详情页 detAIl.vue:展示字段、子表展示 API 文件 src/API/<模块>.ts:接口路径、参数、响应结构
后端代码(<后端项目>/<模块>/):
DO/Entity:字段定义、类型、约束 控制器:接口路径、参数 服务/服务Impl:业务逻辑、状态流转、关联操作 BPM 列出ener(如有):审批流程、状态变更 建表 SQL(如有):字段约束、枚举值、索引
阅读目标:
理解所有功能点和业务规则(哪些字段必填、哪些有枚举约束、哪些有唯一性限制) 理解状态流转逻辑(草稿→审核中→已通过/已驳回) 识别边界值(字段长度限制、数值范围、格式要求) 识别关联关系(主子表、外键约束)
基于代码理解,测试时额外关注:
前端校验与后端校验是否一致 枚举值是否完整展示 状态流转是否按业务逻辑正确变更 子表数据是否正确关联保存 接口异常时前端是否有友好提示 测试类型判断
拿到页面后,先判断页面类型,再选择对应测试策略:
增删改查类页面(有列表 + 新增/编辑/删除/搜索等按钮) → 严格按照下方"每个模块的标准测试步骤"执行完备闭环测试
非增删改查类页面(如数据看板、图表展示、配置项、流程审批、详情只读页等) → 枚举页面上所有可交互元素(按钮、链接、筛选器、标签页、下拉框等),逐一测试:
每个按钮/链接点击后验证响应结果 每个筛选/切换操作验证数据变化 每个跳转验证目标页是否正确加载 关键数据展示是否正常(无空白、无报错、无乱码) 全程截图留证,记录异常 工具要求
必须使用 代理-browser,不用内置 browser 工具(动态弹窗在 访问ibility tree 中不可见)。
代理-browser open 代理-browser snapshot -i --json 代理-browser 命令行工具ck @eN 代理-browser fill @eN "内容" 代理-browser press Enter 代理-browser wAIt --load networkidle 代理-browser screenshot <名称>.png
截图统一保存到报告目录的 screenshots/ 子目录,命名格式:模块-操作-状态.png
每个模块的标准测试步骤
- 页面初始化
- 搜索/筛选
- 新增(完整闭环)
边界值测试(不可省略):
必填项为空 → 验证报错 → 截图 文本超长 → 验证截断或报错 → 截图 特殊字符(