打开浏览器只是准备工作。真正的选择是:你要改变一个网页里的状态,整理一批网页数据,还是证明一次产品改动没有破坏关键流程?这三类任务都可能用到浏览器,但输入、权限和完成标准不同。比如抓一份公开目录,关心的是字段完整和来源可追溯;验证设置保存,关心的是刷新后能否读回正确的值。
先选路径,再挑工具
如果任务只是读取公开静态页面,先看页面内容是否已经在 HTML 里,或者站点是否提供数据出口。页面必须执行脚本、翻页或切换条件才出现所需数据时,才需要浏览器。需要点击、填写或验证交互时,先确认浏览器控制能力、目标域名和允许使用的账号。Skill 提供工作说明,实际能访问什么取决于运行客户端和权限。关联的 SkillPI Webapp Testing 适合在已运行的 Web 应用中组织 Playwright 交互与断言,可用于下文的表单操作和 UI 回归。批量数据提取还要另行决定获取、缓存与清洗方式。
场景一:替你完成一段明确的网页操作
从测试账号的通知设置开始。任务单写清目标站点、账号、初始状态、要改的字段、完成标准和恢复方式。例如允许在测试站打开通知,禁止修改邮箱或其他设置,最终恢复原值。涉及公开发布、付费或影响他人的操作,按实际授权设定最后一步由谁执行。登录过期、出现异常弹窗或进入其他域名时,停下来记录阻塞。
操作时先确认当前页面和账号,再读出开关状态。通过控件名称定位开关和保存按钮,避免用位置坐标描述。保存后先观察提示,再刷新页面读回设置。提示出现只说明页面反馈发生了,刷新读回才回答是否保存。恢复时也要重新加载确认。如果系统会向真实用户发送通知,先在测试环境隔离外发渠道。
交付记录包含起始网址、原值、操作步骤、预期值、实际值、恢复结果。失败时写清第一个未达预期的步骤:是控件找不到、保存按钮不可用,还是提交成功后数据没有持久化。遇到超时先查当前状态,确认此前请求没有完成后再决定是否重试。
场景二:把公开目录提取成可以复查的数据
假设你要采集公开活动目录。先定义字段:活动名、开始日期、地点、详情链接和采集时间。先选两页手动核对结果,标记日期缺失和地点多值如何处理。读取入口、详情页和翻页规则也要写进记录。对于允许访问的数据,优先采用站点提供的导出或稳定接口。
静态页可以用 HTTP 获取后解析,成本通常低于逐页打开浏览器。遇到渲染后才出现的列表,使用浏览器等待实际列表或空状态出现,记录筛选条件和页码。无限滚动应设终止条件:新条目数连续为零、已到最后一页,或者达到本次任务上限。每批保存原始记录和规范化结果。用稳定 ID 去重,缺少 ID 时可以用规范化详情地址,并保留发现来源。
验收时抽查第一页、中间页和末页,核对字段和记录数。把空结果、访问失败与字段缺失分别计数,避免把请求失败误当成目录没有数据。断点记录保存最后一页和已处理 ID。遇到站点限流按提示减速或停止,对登录、访问权限和数据范围按站点规则处理。
场景三:把版本回归拆成行为检查与截图检查
假设设置页升级了布局组件。回归选三条主路径:打开并保存成功、提交失败且保留输入、刷新后确认状态。为失败路径准备确定的测试数据,让它每次可复现。用 Webapp Testing 将检查组织成浏览器用例,给每步写明等待条件和断言。等待“已保存”状态出现比固定等三秒更能解释测试结果。
截图适合比较视觉表现,例如窄屏按钮是否截断、错误提示是否遮挡表单。拍摄基准和新版本时固定视口、浏览器、语言、数据与字体,避免动态时间戳制造噪声。看到差异先定位相关区域,再判断是预期的设计变更、字体或环境变化,还是实际回归。涉及键盘焦点和表单保存的判断仍要通过行为检查来验证。
报告写清版本、环境、用例、预期和结果。每个失败给出最短复现路径和一条有效证据。比如“390 像素宽下,保存失败提示将按钮推到视口外”比“移动端看起来不对”更容易修复。修复后先重跑失败用例,再复测成功和取消路径。
一份可直接修改的任务单
- 目标:在测试站复验通知开关保存、刷新读回和恢复原值。
- 范围:仅测试账号和设置页;发现重定向到登录或其他域名时停止。
- 准备:明确浏览器控制能力、测试账号、初始值和可用的失败响应样例。
- 步骤:记录原值,切换并保存,等待明确反馈,刷新读回,再恢复并复验。
- 产物:逐步结果、失败的最短复现路径、必要截图和待核对项。
- 判定:提交反馈与刷新后结果分别记录,清理失败必须单独报告。
把任务单改成提取任务时,目标换成带来源的字段清单,产物换成数据文件、失败列表和抽查记录。改成回归任务时,再加入版本、浏览器和视口,明确要覆盖的成功与失败路径。
常见故障与处理方法
浏览器有日志,却看不到窗口
先确认启动的是无头模式还是带窗口模式,再检查控制端绑定的浏览器实例和标签页。调试期间可以先验证页面地址、标题和截图,确定访问的是同一个会话。
录制能跑,脚本一重放就失败
检查控件名称是否唯一、页面是否还在加载、选择条件是否跨会话改变。将等待改为列表出现、按钮启用或状态提示出现等可观察条件,并用固定测试数据重试。
要保留所有截图或网络记录吗
为每个失败保留足以定位原因的证据。只读提取通常保存源网址、采集时间与失败原因。回归可保留失败截图和必要的环境信息。若记录中包含账号、令牌或私有数据,先清理再分享。
每个场景需要独立安装一个 Skill 吗
先看当前工具能否完成任务。简单静态提取可能只需要 HTTP 客户端和解析器;稳定交互回归需要明确的浏览器动作和断言。先试一个最小任务,发现缺少具体能力再增加工具。安装前核对原始说明、运行前提、许可和访问范围。
继续实践
先用一个测试页面走通交互验收,再扩展到目标目录和回归用例。相关技能卡片给出 SkillPI 的详情入口,里面有使用前提和来源。想进一步把需求写成能自动执行的检查,可以阅读验收用例拆解。