移动浏览器 Profile 质量复核
一套面向移动浏览器 Profile 的质量复核方法,覆盖视口状态、键盘与触控旅程、版本配对、证据和复核节奏。
BotBrowser Team
移动 Profile 的质量取决于完整任务是否能完成,而不是启动时的一张截图。BotBrowser 支持在受控上下文中加载已批准的移动 Profile 来检查这些节点,但不能保证真实设备上会有相同表现。应在视口变化、键盘焦点、触控反馈、已存状态以及产品实际支持的恢复路径中复核一组已批准的浏览器与 Profile 配对。
要点
将 browserVersion、profileRevision、语言区域、路由和状态策略一起记录。只有带负责人旅程达到预期确认状态,并能经由文档化恢复路径返回时,才接受这组配对。
内容
从已批准的配对开始
移动 Profile 的质量复核从两个明确的输入开始:浏览器版本,以及为该版本批准的 Profile 包。在打开第一个页面之前先记录这组配对。即使 Profile 本身没有变化,浏览器更新也可能改变布局表现、输入处理、存储时序,或页面在导航之后的恢复方式。围绕配对来复核,结果才有清楚的边界。BotBrowser 可以在受控上下文中加载移动端配置,便于复核成对的结果,但不能保证在其他构建、平台或真实设备上得到相同的结果。
把应用构建版本、主机镜像、语言区域、路由策略、已存状态方案和测试账号一并记在配对旁边。这些不是装饰性信息,它们说明移动旅程是在什么条件下被接受的,也让下一轮复核可以对照比较。无法关联周边条件的结果,很难长期维护。
复核同时关注隐私和产品质量。Profile 应当为获准的移动旅程呈现一致的浏览器身份,应用则应当在可见区域变化、字段获得焦点、用户短暂中断后返回时仍然可用。如果你想进一步了解身份一致性这一侧,可以阅读 Android、iOS 与桌面浏览器的移动身份一致性。
在完整旅程中做判断
第一个页面看起来正确,并不代表后面的流程没有问题。移动产品经常在紧凑导航、表单、确认页面和返回路径之间切换。每次转场都可能改变可用内容区域,以及用户下一步需要的控件位置。复核要跟随这种变化,而不是把第一张截图当作全部结果。
先明确受支持的旅程。一份有用的记录会写明谁负责这条流程、使用哪个账号或已批准的测试数据、用户需要完成什么,以及旅程在哪里结束。记录每个转场时的 location.pathname,使旅程结果能对应到实际路由。既要包含正常的成功路径,也要包含一条恢复路径,例如保存后刷新、跳转后返回,或重新打开刚更新过的记录。
在整个旅程中保持身份边界稳定。移动 Profile、存储策略、路由策略和应用账号属于同一份已批准的会话记录。边界一旦变化,就开始新的会话。这样产品结果更容易理解,也保护了 Profile 的隐私用途。
把视口当作旅程状态
视口质量不只是检查宽度。用户可能从同时看到页头、内容区和底部操作的状态开始。打开菜单、聚焦字段或从其他页面返回之后,可见区域可能重新排布。要写明重要状态,以及在状态之间切换的动作。关于相关度量的背景,可参阅 用于响应式设计的屏幕与视口属性。
对每个状态,记录必须保持可达的内容、应当获得注意的控件,以及确认进度的消息。页面提供 VisualViewport 时,同时记录 visualViewport.width、visualViewport.height 和 visualViewport.offsetTop。检查第一个有用动作、主要操作和最终确认。页面样式可能完好,却把必需控件放进被遮挡的区域,或者让用户找不到返回路径。标题、标签和校验消息仍应沿着合理的阅读路径排列。
使用少量稳定的检查点。提交前填好的表单、保存后的确认,以及从导航菜单重新打开的记录,往往比收集每一屏更有信息量。每个检查点都带上语言区域、Profile 类别、应用构建版本和命名后的视口状态。
只有产品明确支持时,才复核方向或可用空间的变化。不要从缩小后的桌面页面推断移动端支持。以产品向用户承诺的旅程为准,把不受支持的状态记为批准范围之外,而不是悄悄当作通过。
让键盘复核跟随字段
键盘可见状态是真实移动表单旅程的一部分。重要的问题不只是字段能否接受文字,而是在键盘占用一部分可见区域时,焦点字段、标签、当前值、下一步操作和校验消息是否仍然清楚。
选择代表产品真实工作的字段:登录、搜索、地址、备注或确认信息。通过受支持的用户动作聚焦每个字段。把 document.activeElement 对应元素的 id 或 name 写入结果,避免仅凭截图猜测焦点。确认字段仍然容易识别,插入点可见,下一个控件无需丢失上下文就能到达。提交或取消之后,确认焦点移动到有用的位置。
既要复核输入有效的情况,也要复核输入不完整的情况。校验消息应与需要处理的字段关联,并且在用户修正数值、切换到其他字段或经过页面转场后仍然可用。产品应按其声明的行为保留已输入的信息。
Mobile Keyboard Viewport 是一种复核状态:键盘可见,可用视图变小。把它当作产品层面的状态来看待,评估由此产生的布局、焦点表现和用户动作,不对某款手机上原生操作系统键盘的行为作任何声明。
复核还应覆盖收起与返回。用户可能收起键盘以阅读更大的确认区域,重新打开键盘修正字段,或离开表单稍后再回来。每个动作都应保持预期的应用状态。如果产品有意清空某个值或重置焦点,就把这种行为写进预期结果。
把触控当作一组连续动作
触控旅程有自己的节奏。用户打开控件、选择项目、确认变化,然后检查结果状态。质量复核应当跟随整个顺序和可见反馈,而不是让每个控件只被点一次。
使用客户真正会走的路径。打开紧凑导航,选择目的地,滚动到某条记录,打开它的操作菜单,保存后回到该记录。将触发操作的 pointerdown、pointerup 与后续 click 事件列入路径记录,区分一次连续触控与仅有最终点击。如果产品包含卡片、列表行、标签页、对话框或媒体控件,就复核把它们连起来的完整路径,包括产品支持的上传或播放的开始、进度、取消和最终状态。
关注焦点和反馈。选中的标签页需要可见的选中状态,菜单需要清楚的打开和关闭状态,保存操作需要产品层面的确认或易懂的失败消息。把这些序列重复几遍:打开并关闭同一个面板,在字段之间切换,取消对话框,再回到已保存的项目。这些步骤会暴露单次向前点击看不到的状态。
使用真实旅程,并把布局与行为放在一起
选择代表有意义工作的旅程:账号登录、搜索、结账、文档审阅、媒体播放、消息或仪表盘更新。静态落地页适合做基础可用性检查,但很难说明包含表单、导航、存储或恢复的流程。把每条旅程写成一小串产品动作和预期状态,从已批准的测试账号出发,到稳定的确认页面或有文档说明的失败状态结束。每个转场记录 location.pathname 和 document.documentElement.lang,以便将路由和语言区域与结果对应。
保证测试数据安全。使用应用负责人授权的账号和内容。在截图中遮蔽个人信息,并从共享记录中移除密钥、令牌和客户内容。移动复核要像保护 Profile 边界一样,认真保护验证过程中涉及的个人数据。
把路由和语言区域写进基线,因为翻译后的操作文字可能换行方式不同,地区策略也可能改变可用内容。如果持久性属于产品承诺,就分别运行一次新会话和一次回访会话。新会话检查进入与准备,回访会话检查已保存的状态在预期的上下文中是否仍然可用。
截图有助于判断布局,但批准决定还应包含用户能否完成任务。外观相近的页面如果丢了保存操作、丢了校验消息或堵住了返回路径,就不是成功的移动复核。每个视觉检查点都配一条简短的行为说明:用户打开了面板,编辑了已批准的字段,保存后看到确认,返回后找到了变更。对于表单步骤,附上 HTMLInputElement.validity.valid 的结果;它只描述浏览器约束校验,不能替代产品规则。
为移动和桌面旅程分别保留基线。它们可以共用一个账号或业务结果,但布局、输入顺序、导航模型和恢复路径可能不同。移动端通过不应悄悄批准桌面布局,桌面端通过也不能替代受影响的移动复核。书面记录只围绕已批准的 Profile 家族、可见结果和发布决定。
把每个 Profile 与其浏览器版本配对
浏览器和 Profile 在批准时是一个发布配对。新的浏览器包即使没有更换 Profile 分配,也可能改变页面兼容性或输入行为。新的 Profile 包即使浏览器版本不变,也可能改变已批准的身份方案。在配对记录中写入 Profile 包标识符和本会话的 navigator.userAgent 值;后者将观察结果关联到实际启动的浏览器,但不替代包版本。要复核实际将要运行的组合。
分阶段推进。先在受控环境中启动候选配对,应用构建版本、路由类别、语言区域、策略和已存状态方案都与已接受的基线对齐。运行有代表性的移动旅程,复核发生变化的检查点,并取得产品和隐私方面所需的签核。观察期内保留最近一次已接受的配对,如果候选被撤回,就把已批准的浏览器和 Profile 一起恢复。
已批准的包不可用时,避免自动改用无关的移动 Profile。被阻止的启动是可见且可处理的。而带着未经复核的分配成功启动,可能得到一张好看的截图,却削弱了隐私边界和发布记录。主机镜像变更、应用集成变更或策略更新也适用同一条规则:把变化的输入单独记录。
从小而清楚的基线开始
新移动 Profile 的第一次复核,范围应大到能覆盖它承诺的旅程,又小到负责人能够理解。包括进入、导航、一个有代表性的表单、键盘可见时的编辑、触控确认、一个恢复步骤和一次干净的关闭。只有产品依赖媒体或上传时才加入相关内容,并在运行前写好预期状态。
让验收用语务实。“已接受”表示命名的旅程在记录的配对下到达了批准的状态;“已变化”表示观察到的结果不同并且有负责人;“已阻塞”表示外部依赖使有效运行无法进行;“不确定”的结果不能当作批准证据。在新会话中重复旅程,避免一次临时的服务响应或过期存储决定结果。
区分产品变化和环境变化
移动端结果发生变化时,先在记录的条件下重复旅程。在更换浏览器配对之前,检查应用可用性、测试账号状态、测试数据状态和路由健康状况。服务响应或过期账号可能产生与发布变更相同的可见症状。
如果差异重复出现,就在固定应用和旅程的前提下,比较最近一次已接受的配对与候选配对。比较记录应保留 navigator.userAgent、location.pathname 和应用构建标识符,明确哪些输入保持不变。如果变更后的应用构建仍然可用,第二次比较可以固定配对、改用变更后的应用。这些受控比较让每位负责人都得到证据,而不必把记录写成技术调查。
按可见阶段对差异分类:启动、首次导航、菜单打开、表单输入、键盘视图、保存确认、跳转、持久化、媒体或关闭。日程允许时,一次只改变一个发布输入。如果紧急情况需要合并更新,就记录全部输入,并指定一位复核人负责合并后的结果。
检查恢复与已存状态
恢复也是质量的一部分。产品承诺持久性时,保存后刷新页面,或离开后再返回。跳转之后,确认用户回到有用的状态。临时中断之后,使用产品支持的恢复路径。
已存状态需要明确的策略。持久的授权会话可以保留继续使用所需的状态;一次性的复核可能要求干净关闭,且不保留应用数据。运行前记录策略,运行后执行策略。没有负责人的明确决定,不要把旧的已存状态附加到新分配的 Profile 上,并且要像检查启动一样认真检查关闭。
让节奏、证据和责任跟随变化
有用的节奏分两部分。发布输入变化时做一次针对性复核,配对仍在使用期间做定期健康复核。前者在变化源头附近发现问题,后者发现应用旅程、主机环境、路由策略或已存状态流程中的漂移。
新的浏览器版本、新的 Profile 包、移动布局变更、与键盘相关的产品变更、导航改写、策略变更、主机镜像更新或关键集成变更,都应触发针对性复核。受影响的旅程优先,其后是一条应当保持稳定的小型对照旅程。定期复核的间隔由旅程负责人决定,并淘汰不再符合受支持产品行为的检查。
让证据易于阅读
发布记录应回答五个实际问题:运行了哪一组浏览器与 Profile 配对,使用了哪条旅程,用户观察到了什么,谁做了复核,随后做出了什么决定。让这些字段在移动和桌面报告之间保持稳定。
使用带遮蔽的截图(对应命名的检查点)、简短的应用消息、旅程结果、语言区域、视口状态和一条恢复说明。证据按组织的保留与访问规则存放,因为移动端屏幕可能包含账号信息、私人消息、地址或文档内容。敏感证据删除之后,仍要保留决定及其负责人。
清楚标记被阻塞或不确定的运行。服务不可用并不能证明配对通过或失败。等依赖恢复后重新运行,再用新的处置结果更新同一份旅程记录。
分阶段决定,并明确责任人
当命名的移动旅程到达预期的产品状态,视口和键盘状态仍然清楚,触控操作有明确反馈,恢复符合记录的行为,并且证据有人负责时,批准该配对。每项决定使用稳定的 decisionId,并关联 profilePackageId、应用构建标识符和旅程记录。变化的结果缺少处置,或必需的旅程无法完成时,暂缓该配对。带例外批准时,写明例外、负责人、下一步动作和到期时间。
每个移动 Profile 都应有身份记录负责人、产品旅程负责人和发布批准人。小团队里一个人可以身兼数职,但决定仍需有清楚的署名。在共享记录中使用中性标识符,把 Profile 内容、账号密钥和路由凭据放在受保护的系统里。
质量复核在发布之后仍要继续。把决定关联到应用构建版本、浏览器版本、Profile 修订和旅程记录,并保留最近一次已接受的配对用于对照。客户反馈移动布局或输入问题时,从最接近的已接受记录开始,而不是凭记忆重建上下文。
BotBrowser 在复核中的位置
Mobile Keyboard Viewport 应当放在旅程基线旁边,而不是取代基线。它帮助复核人员在可用视图变小时讨论字段、校验消息、操作控件和确认内容的位置。记录复核的是哪一个可见状态、由哪个用户动作产生,避免把单个视图当成对所有移动屏幕的结论。
BotBrowser 支持与之匹配的 Android 或 WebKit 系移动 Profile,并提供由 Profile 定义的触控支持。借助文档说明的 --bot-mobile-keyboard 选项(需要手动启用,默认关闭),可编辑字段通过可信的用户操作获得焦点时,visualViewport.height 会减小,而布局视口保持不变。复核人员因此可以在同一个有文档记录的 Profile 条件下,重复同一条已批准移动旅程中的键盘可见与触控检查点。BotBrowser 不能保证每台真实设备或每种应用布局的表现都相同,不能替代物理设备和原生操作系统键盘的复核,也不替代旅程责任、证据处理或发布签核。
把这项能力用于可重复的检查点,决定仍由你的团队来做。更广泛的设备 Profile 选项可阅读 手机、平板与桌面设备 Profile 测试。对于文档中没有为该 Profile 说明的设置,应记录为复核范围之外,而不是想当然。
实践结论
移动浏览器 Profile 质量复核是一门务实的功课。它把移动 Profile 承诺的身份,与用户实际使用的可见状态和操作联系起来。视口变化、键盘可见时的编辑、触控导航、持久性和恢复,都属于同一场发布讨论。
最有力的结果很容易说明:一组命名的浏览器与 Profile 配对、一条真实的用户旅程、一小组有用的检查点、一位明确的负责人,以及与下一次重要变更挂钩的复核日期。这样的记录保护隐私,支撑产品质量,也让团队有稳定的方式判断移动发布是否就绪。
公开来源
本文属于指南: Web 平台能力面:一致性复核地图