请说明 Playwright 在执行点击等操作前会做哪些可操作性检查、这些检查的具体判定标准,以及自动重试断言应该如何使用。
Playwright 在执行动作前会对目标元素做一系列可操作性检查(actionability checks),自动等待所有相关检查通过后才真正执行;若在给定 timeout 内仍不满足,则动作失败并抛出 TimeoutError。
以 click() 为例,它会检查:定位器精确解析到唯一元素、元素 Visible、Stable、Receives Events、Enabled。
visibility:hidden。注意——零尺寸元素不算可见,display:none 不算可见,而 opacity:0 算可见。disabled 属性的 button/select/input/textarea/option/optgroup、位于带 disabled 的 fieldset 内的元素、以及祖先带 aria-disabled=true 的元素。不同动作的检查组合不同:click 要 Visible + Stable + Receives Events + Enabled;fill 要 Visible + Enabled + Editable;hover / dragTo 只检查 Visible + Stable + Receives Events;而 focus()、press()、dispatchEvent() 不做任何检查,需自行保证前置状态。
传统脚本的痛点在于「代码执行」与「浏览器状态」之间的竞态,只能靠人肉 sleep 去猜时间。Playwright 把等待改成基于状态而非基于时间的判断:条件满足立刻继续,不满足就一直等到超时。这既消除了猜时间带来的偶发失败,又不会像固定 sleep 那样无谓拖慢执行。
典型例子是「先禁用、服务端校验唯一性通过后才启用」的注册按钮——无论何时调用 click(),Playwright 都会自动等到按钮真正可点,脚本里不需要任何等待代码。
除了动作前的等待,Playwright 的断言(如 toHaveText()、toBeVisible()、toHaveCount()、toHaveAttribute())同样会自动重试直到条件成立或超时。这正是它消除 flakiness 的另一半能力,应优先使用,不要自己 sleep 之后再取一次值做比较。
force: true 会跳过非必要检查(例如不再验证元素是否真的能收到点击事件)。只在明确知道后果时使用,滥用会把 flaky 掩盖成更隐蔽的问题。题目与答案就在本页;收藏、批注和错题重练在应用内