多标签页自动化的工程细节:标签治理、Target closed 与后台节流
多标签页自动化的工程细节:标签治理、Target closed 与后台节流
一个每天固定跑一次的浏览器自动化流程,实际会在六到十个标签页之间来回切换:成长中心读任务状态、登录页拿票据、博客编辑器写正文、案例详情页停留计时、GitCode 点 Star、云沙箱进桌面。单个页面上的操作都不复杂,真正把脚本拖垮的往往是"页面之外"的东西——标签页的生命周期、扩展的目标绑定、以及 Chromium 对后台页面的节流。
这篇记录几个反复踩到、并且有明确修法的点。
一、Target closed 有三种来源,处理方式完全不同
报错文本都是 Target page, context or browser has been closed,但成因分三类:
1. 页面自己跳转/关闭。 云实验沙箱点完"结束实验"并确认后,标签页会被系统主动关掉。此时脚本里紧跟的 waitForTimeout 或 evaluate 必然抛错。这不是故障,是流程的正常终点。正确做法是把"结束实验"之后的等待包在 try/catch 里,捕获到 Target closed 就当作成功继续:
try {
await page.getByText('确定').click();
await page.waitForTimeout(3000);
} catch (e) {
if (!/Target (page|closed)|has been closed/i.test(e.message)) throw e;
// 页面已被系统回收,属正常
}
2. 主动批量关闭时关到了"当前页"。 遍历 context.pages() 逐个 close(),当循环关到 Playwright 当前绑定的那一页时,后续代码立刻失去上下文,抛 Target closed。所以批量清理要分两段:先关掉除当前页以外的所有页,再用标签管理接口单独关最后一个。
3. 浏览器扩展整体重启。 这是最麻烦的一种:所有标签页同时消失、登录态失效,重连后拿到的是一个全新的 about:blank。它和"账号异常"表现完全不同——账号异常是页面能开、但被踢回登录页;扩展重启是连页面都没有。区分清楚能省掉一次误判。
二、后台节流会让"可见"操作莫名超时
页面切到后台一段时间后,Chromium 会降低定时器频率、暂停部分渲染工作。直接后果是 scrollIntoViewIfNeeded() 卡满 30 秒超时,locator.click() 报 waiting for element to be visible/stable。代码没错,是页面没有被真正激活。
两个层次的修法:
// 层次一:把页面提到前台
await page.bringToFront();
// 层次二:绕过可见性等待,但仍走真实事件
await locator.click({ force: true });
force: true 跳过的是"等待元素可交互"的轮询,仍然派发真实的鼠标事件序列,所以业务侧该触发的监听器一个都不会少。它和 element.click()(JS 直接调用 DOM 方法)有本质区别:后者不经过命中测试,元素在视口外或被子元素遮挡时点击会被吞掉。经验是——能用 force click 就不要用 JS click,除非确认过 JS click 在这个站点的确有效。
三、有些按钮必须用鼠标坐标,因为可交互性判定永远不通过
典型场景是弹窗里的主按钮:元素被上层透明层覆盖、或者 CSS 里带 pointer-events 相关的过渡动画,Playwright 的可交互性检查会一直等到超时,force: true 也可能因为命中测试落到遮罩上而无效。这时唯一稳定的是把鼠标移动、按下、抬起拆成三步:
const r = await locator.boundingBox();
await page.mouse.move(r.x + r.width / 2, r.y + r.height / 2);
await page.mouse.down();
await page.mouse.up();
三步之间留 100~300ms。一步到位的 mouse.click(x, y) 在部分富文本/弹层组件上会丢事件——按下和抬起落在同一个事件循环里,组件内部的"按下后启用"逻辑来不及跑。
四、画布型桌面的坐标要换算
云沙箱的远程桌面是 canvas 渲染,元素级定位全部失效,只能靠坐标。而坐标有两个坑:
- 截图尺寸不等于 CSS 尺寸。 先取 canvas 的
getBoundingClientRect(),再取截图实际宽度,两者相除得到比例,把截图里量到的图标位置折算回页面坐标。 - 桌面操作必须是真实双击。
page.mouse.dblclick会派发两组 down/up 加 dblclick 事件,远程桌面协议才认;JS 合成的事件到不了远端。
同理,窗口分辨率一变,之前记下的坐标全部作废。脚本里应该先截图、再定位,而不是硬编码一堆坐标点。
五、跨域 iframe 是另一个上下文
如果目标 UI 全部在一个跨域 iframe 里,顶层 page.evaluate 看不到任何按钮,page.getByText() 在顶层会稳定超时。必须先按 URL 片段把 frame 找出来:
const f = page.frames().find(fr => fr.url().includes('5173-'));
await f.locator('button', { hasText: '新建会话' }).last().click({ force: true });
注意两点:一是 iframe 内的按钮同样容易卡在 stable 检查上,force: true 是常态;二是键盘事件反而在顶层可用——焦点在 iframe 的输入框里时,page.keyboard.press('Enter') 能正常发送,不必再往 frame 里找发送按钮。
六、一份可复用的检查表
跑完一轮之后我固定做这几件事:
- 列一次标签页清单,确认只剩初始页;
- 对每个"提交类"动作单独记一行日志:提交时间、成功标志(URL 变化或成功页文案);
- 对异步计分/审核类动作,不在当场反复刷新验证——只记"已提交",到收尾统一对账一次;
- 任何一步失败,错误信息原样保留,不要吞掉后继续跑下一步,否则后面全是连锁误判。
自动化的可靠性不来自"多写几个重试",而来自把失败分类:哪些是页面正常关闭、哪些是脚本定位不到、哪些是平台侧异步延迟。 分清这三类,脚本的误报率会掉一个数量级。
小结
浏览器自动化的难点很少在"点不到按钮",而在时序与上下文:谁在前台、谁被节流、谁已经死了。把 Target closed 分成正常/误伤/环境重置三类,把点击分成真实事件/force/坐标三档,把 iframe 当成独立上下文对待,一个每天无人值守跑的流程就能稳定很多。
- 点赞
- 收藏
- 关注作者
评论(0)