复现Playwright站点mobile-geolocation脚本时出现输出异常问题

核心排查方向（按优先级排序） #

• 设备模拟配置校验
  手动在Chrome开发者工具中添加的模拟设备不会被Playwright识别，必须在创建浏览器上下文时显式传入Playwright内置的设备描述符。需检查代码中是否完整传递了userAgent、viewport、deviceScaleFactor、isMobile、hasTouch全部设备参数，不能仅单独设置某一项模拟参数。
• 定位权限配置校验
  位置权限授权必须在页面加载前完成，需在创建浏览器上下文后立即调用权限授予方法，且指定正确的授权源：

  await context.grantPermissions(['geolocation'], { origin: 'https://maps.google.com' })
  

  不能等页面弹出权限请求弹窗后再操作授权，否则会导致页面直接终止位置初始化流程。
• 元素匹配逻辑优化
  Google地图是动态多语言渲染的页面，固定文本匹配的选择器稳定性极低。需将硬编码的文本选择器替换为带正则模糊匹配的角色选择器，兼容不同语言、不同版本的页面渲染内容，同时补充元素加载等待逻辑，避免在页面未渲染完成时触发操作。
• 上下文参数完整性校验
  检查创建上下文时是否显式传入两项关键参数：
  1. 模拟定位参数：geolocation: { latitude: 37.819722, longitude: -122.478611 }
  2. 匹配的区域设置：locale: 'en-US'
     避免因区域不匹配导致的页面跳转、内容渲染异常。
• 调试验证步骤
  开启headless: false的可视化调试模式，逐节点记录页面状态截图，对照官方脚本的执行流程逐段验证：
  1. 打开Google地图后确认页面无异常跳转
  2. 点击定位按钮后确认地图视角自动切换到模拟的经纬度位置
  3. 校验地图中心点坐标和传入的模拟值偏差在允许范围内
     若某一步操作超时，直接打印当前页面的URL、所有可见按钮的文本列表，即可快速定位是加载延迟、授权失效还是选择器匹配错误的问题。

所有排查点均匹配官方mobile-geolocation示例的配置要求，无需额外修改核心业务逻辑。

内容的提问来源于stack exchange，提问作者Paul Gureghian