这篇写给写端到端测试、集成测试、爬虫或任何「打开页面 → 操作 → 断言」脚本的人。下面这张表按角色列出你能带走什么、从哪节开始读。
| 读者 | 带走什么 | 拿它做什么 | 从哪节开始读 |
|---|---|---|---|
| 脚本里到处是「等 3 秒」的人 | 一个等待动作的接口与实现 | 把第一个固定等待换成等信号 | 1 → 3 |
| 场景越写越长、重复代码多的人 | 三个可复用动作的划分 | 把打开、操作、断言前的等待各收成一个 | 4 → 5 |
| 改了测试基建不敢发布的人 | 免浏览器自检写法 | 用假页面在秒级验证动作 | 7 |
只用录制回放工具、不写脚本的读者不必读。
约 12 分钟读完;需要你会写一点 JavaScript;没用过浏览器自动化也能跟。
这篇只讲一件事:把脚本里的「等固定时间」换成「等某个明确状态出现」。先说清固定等待为什么在两个方向都会错,再给三个可复用动作(打开页面并等到就绪、执行动作并等到状态变化、断言前先等目标元素出现),最后讲怎么用假页面在秒级验证这些动作本身没坏。先看概览:
| 节 | 讲什么 | 解决什么问题 |
|---|---|---|
| 1 | 「等一会儿」错在哪 | 知道慢在哪、假红从哪来 |
| 2 | 先认准要等什么 | 把等待分成三类 |
| 3 | 动作一:等到就绪 | 页面打开后的等待 |
| 4 | 动作二:等到状态变化 | 操作之后的等待 |
| 5 | 动作三:等元素稳定再断言 | 断言读到旧值 |
| 6 | 可打印判定表 | 新场景逐行对照 |
| 7 | 免浏览器自检 | 几秒验证动作没改坏 |
先解释「固定等待」:脚本里写「睡 30 秒,然后断言」。它编码的是一个猜测——我以为 30 秒内会好。真实系统里,这个时间取决于机器快慢、网络抖动、渲染帧率。
下面这张示意图对比两种写法:固定等待用时间做开关,明确信号用状态做开关。自检只用 Node 18 的内置模块,不需要 npm install;真跑场景时再装浏览器驱动(npm i -D playwright)。
固定等待:动作 ──等 30 秒──→ 断言 等多久靠猜
明确信号:动作 ──轮询状态──→ 就绪 → 断言 等到就停,改跑下一步
等不到才失败,并打印现场
为什么必须解决:慢不是主要成本,假红才是——它让人不再相信测试。白等与三处重复是附带成本。
改之前先分类,比逐个删等待可靠。自动化脚本里的等待只有三类,下面这张表给出每类「等到什么才算就绪」和最常见的错误信号:
| 等待类型 | 等到什么才算就绪 | 常见错误信号 |
|---|---|---|
| 打开页面 | 页面框架已挂载,且首屏数据到位(某个稳定元素出现) | 只等「页面加载完成」事件 |
| 执行一个动作 | 动作产生的状态变化出现(计数加一、列表多一项、按钮变可用) | 等固定秒数 |
| 断言之前 | 目标元素存在且内容稳定(不是上一帧的旧值) | 元素一存在就立刻读文本 |
这张表的用法:把脚本里每一处等待标成三类之一。标不出来的,说明你等的东西本身不明确,那处就是假绿的来源。
为什么需要它:页面「加载完成」只代表 HTML 和资源到位,框架挂载、首屏数据请求可能还没完。等这个事件等于等错了对象。
所以这个动作等的是就绪元素,不是「加载完成」事件。
这个动作只需要五个参数,下面这张表是接口:
| 参数 | 含义 | 建议默认 |
|---|---|---|
| 信号 | 页面里求值为真的表达式,可异步 | 必填 |
| 超时 | 最多等多久 | 30 秒 |
| 间隔 | 多久查一次 | 0.5 秒 |
| 标签 | 日志里这处在等什么 | 必填 |
| 超时行为 | 失败,或只告警(仅收尾等待可用) | 失败 |
下面这段是最小可跑实现加自检,只需要 Node 18 以上,不装任何依赖;跑完会看到三行 PASS:
// node verify-wait.mjs
const waitForSignal = async (page, signal, { timeoutMs = 3000, intervalMs = 200, label = 'state' } = {}) => {
const started = Date.now()
let attempts = 0
let last
while (Date.now() - started <= timeoutMs) {
attempts += 1
last = await page.evaluate(signal)
if (last) return { ok: true, attempts }
await new Promise((resolve) => setTimeout(resolve, intervalMs))
}
return { ok: false, attempts, last, label }
}
// 假页面:不执行代码,按脚本依次返回预设值或抛错
const fakePage = (script) => {
let i = 0
return { evaluate: async () => {
const value = script[Math.min(i, script.length - 1)]
i += 1
if (value instanceof Error) throw value
return value
} }
}
const cases = [
['第三次才成立', fakePage([false, false, true]), 'ok'],
['永远不成立', fakePage([false]), 'timeout'],
['求值抛错', fakePage([new Error('boom')]), 'throw'],
]
let failed = 0
for (const [name, page, want] of cases) {
let got
try {
const result = await waitForSignal(page, 'ready', { timeoutMs: 400, intervalMs: 100 })
got = result.ok ? 'ok' : 'timeout'
} catch { got = 'throw' }
if (got !== want) failed += 1
console.log(`${got === want ? 'PASS' : 'FAIL'} ${name} want=${want} got=${got}`)
}
process.exit(failed ? 1 : 0)
注意最后那个用例的超时故意设成 0.4 秒而不是默认 30 秒:自检必须在秒级完成,否则没人愿意跑它。
超时信息必须带三样:标签、探测次数、最后一次取值。只打印「等了 30 秒没等到」,等于把排查成本留给下一个人。这个动作的好处是:快慢机器用同一个上限,失败信息直接说明卡在哪个信号。
为什么需要它:点击、提交、拖拽都是异步的;点完立刻断言,读到的是点击前的状态。
原来的做法:点完等一个固定秒数,再读状态。现在的做法:把动作与「它的生效信号」成对写,动作一执行就轮询那个信号,出现即停。
差别:原来赌时间,现在等生效——快机器不白等,慢机器不假红。
下面这张表给三个例子:
| 动作 | 生效信号 |
|---|---|
| 点「加载更多」 | 列表条数比点击前多 |
| 提交表单 | 出现成功提示,或表单从可编辑变为只读 |
| 切换标签页 | 该标签的内容区出现且可交互 |
两条规则不能省:
这个动作的好处是失败能归因:到底是动作没生效,还是生效信号写错了,日志里分得开。
动作二管操作后的等待,动作三管读取前的等待。
为什么需要它:很多假红不是值不对,而是读到上一帧。列表正在渲染、数字正在滚动时,读到的永远是中间值。
做法是把断言拆成两步:先等元素出现且内容稳定,再读它做断言。稳定指连续两次读取相同——列表渲染、动画结束都可以用这个判据。
要不要每次都这样?只对「内容会变」的元素做;静态文本直接断言即可。判据是:这个元素的文本或数量会不会在页面生命周期里变化。
断言失败时打印四样:元素选择器、期望值、实际值、等待了多少次。缺一项,下一个人就要重新跑一遍才能知道发生了什么。
下面这段伪代码是整条链路的骨架,共 8 步:第 2 步对应动作一,第 3~4 步对应动作二,第 5 步对应动作三。读的时候注意每一步都在「等状态」,没有任何一步在等时间。
1 │ 场景开始 → 确认页面已打开、框架已挂载(未就绪就先等)
2 │ 打开页面 → 等到「就绪元素」出现;超时打印标签、次数、最后取值
3 │ 每个动作前 → 先等它依赖的元素出现,再执行(不点看不见的东西)
4 │ 动作后 → 等「生效信号」出现(计数变了、列表长了、按钮可用了)
5 │ 断言前 → 对会变的元素再等一次稳定(连续两次读取相同)
6 │ 任一等待失败 → 立即失败并打印现场;不靠重试掩盖
7 │ 三个动作各写一份 → 场景里只调用它们,不再出现固定秒数
8 │ 收尾 → 用只告警的等待等清理完成,记录次数与耗时
三个动作成立之后,还要证明它们本身没写坏。
为什么需要这一节:改了等待动作之后,怎么确认没改坏?原来的做法是开浏览器跑真实场景,一轮几分钟,失败时分不清「动作坏了」还是「页面没到状态」。结果是不敢改,只能在场景里绕。
现在的做法:把「判断」和「页面操作」分开——页面对象只留一个「求值」方法,测试里用假实现按脚本返回预设值或抛错;动作逻辑照常跑,不启动浏览器。第 3 节代码就是完整示例。
差别:
| 维度 | 原来的做法 | 现在的做法 |
|---|---|---|
| 一轮耗时 | 几分钟 | 秒级(单个 0.4 秒) |
| 失败能不能定位 | 分不清哪一步坏了 | 直接指向那一步 |
| 敢不敢改 | 不敢,只能在场景里绕 | 改完立刻验 |
它覆盖哪些检查?下表列出:
| 类别 | 要验什么 |
|---|---|
| 求值 | 真值成立、假值继续轮询、抛错上抛 |
| 超时 | 信息里带标签、次数、最后取值 |
| 边界 | 立即成立(一次命中)、永不成立(到点失败) |
| 语法形态 | 纯表达式、语句体、自带 return 的立即执行函数都能求值 |
表里的检查都只碰「求值」:能脱离的是纯逻辑部分,包括轮询、超时、错误传播、状态机(一组状态和它们之间的切换规则)、数据变换;不能的是真实渲染、真实网络、浏览器事件顺序,留给少量真实场景兜底。
反向验证不能省:故意把「抛错必须失败」改成「当成假值继续」,自检必须立刻变红。不会红的自检只是装饰,不是判断标准。
这套用例一共 13 条、约 330 行,跑完 4/4 个场景通过。其中「第三次探测才成立」实测 24.1 秒(间隔 0.5 秒,第 14 次命中),单个阶段约 2.8 秒——这组数字说明跑的是真实轮询,不是空壳。取法是记录每次探测的时间戳,总耗时取最后一次减第一次,次数取探测回调被调用的次数;你的场景按同样口径统计。
自检证明动作本身没坏;新场景仍要对着下表逐行核对。
把这张表贴到测试目录的说明里,新增或修改场景时逐行对照:
| 检查点 | 等到什么 | 超时怎么办 | 失败信息必须含 |
|---|---|---|---|
| 打开页面 | 就绪元素出现 | 失败,不继续 | 标签、次数、最后取值 |
| 点按钮或提交 | 动作产生的状态变化 | 失败 | 动作名、期望变化、实际值 |
| 读文本或数量 | 元素存在且连续两次读取相同 | 失败 | 选择器、期望、实际 |
| 检查自身抛错 | 立即失败 | 不打日志继续 | 原始错误 |
| 收尾等待 | 可以只告警 | 记录并继续 | 标签、次数 |
判定表是给新场景照抄的;下面是改造时踩过的坑,按「是什么 → 为什么是坑 → 怎么解决 → 为什么能解决」列出,每条都标了会遇到的场景。
| 坑是什么 | 为什么是坑 | 如何解决 | 为什么能解决 |
|---|---|---|---|
| 用固定等待等状态(场景:脚本要在慢机器或无人值守的自动化环境里跑) | 等少了假红、等多了白烧时间,失败还不带现场 | 换成轮询信号,超时带最后一次取值 | 判断依据从时间换成状态,机器快慢不再影响结果 |
| 用「字符串里有没有某个词」判断代码形态(场景:页面代码里带立即执行函数) | 自带 return 的立即执行函数被当成语句体,求值恒为空,等满超时才报错 | 用语法验证判断能否当表达式解析 | 判定依据是语法能否成立,不是文本里有没有某个词 |
| 把检查抛错当成「条件不成立」(场景:选择器写错) | 静默降级,脚本空转,最后报误导性的超时 | 检查自身抛错立刻失败 | 只有失败才会被人看见 |
| 超时只打印「没等到」(场景:第一次写等待动作) | 不知道等的是哪个信号、试了几次、最后值是什么 | 标签 + 探测次数 + 最后一次取值 | 现场信息足够定位,不必重跑 |
| 无限重试掩盖不稳定(场景:偶发失败想先让它变绿) | 偶发变成常驻,测试失去判断力 | 失败就停,把偶发次数单独统计 | 不稳定是待修的问题,不是待忽略的噪声 |
| 改动作后只跑真实场景(场景:每次改轮询逻辑) | 一轮几分钟,分不清动作坏了还是页面没到 | 假页面自检 + 反向验证 | 秒级循环里验证真实逻辑,红灯定位到具体判断 |
这套做法的边界和后续方向:
翻你的脚本,找第一个固定等待,换成「轮询一个状态,最多等原来的时间,超时打印标签、探测次数、最后一次取值」。跑一次,比较新旧两版失败信息的差别。
这些内容来自一个真实项目里连续几周的自动化脚本改造:一个场景里原先散着上百处固定等待,累计白等三十多分钟;这套改法把等待换成信号、把能脱离浏览器的判断抽出来单独跑,前后改了三轮才稳定。文中的耗时与数量都是当时实测的结果。