自动等待

简介

Playwright 会在执行操作之前对元素执行一系列可操作性检查，以确保这些操作按预期进行。它会自动等待所有相关检查通过，然后才执行请求的操作。如果必需的检查未在规定的 timeout 内通过，操作将以 TimeoutError 失败。

例如，对于 Locator.click()，Playwright 将确保

以下是为每个操作执行的完整可操作性检查列表：

操作	可见	稳定	接收事件	启用	可编辑
Locator.check()	是	是	是	是	-
Locator.click()	是	是	是	是	-
Locator.dblclick()	是	是	是	是	-
Locator.setChecked()	是	是	是	是	-
Locator.tap()	是	是	是	是	-
Locator.uncheck()	是	是	是	是	-
Locator.hover()	是	是	是	-	-
Locator.dragTo()	是	是	是	-	-
Locator.screenshot()	是	是	-	-	-
Locator.fill()	是	-	-	是	是
Locator.clear()	是	-	-	是	是
Locator.selectOption()	是	-	-	是	-
Locator.selectText()	是	-	-	-	-
Locator.scrollIntoViewIfNeeded()	-	是	-	-	-
Locator.blur()	-	-	-	-	-
Locator.dispatchEvent()	-	-	-	-	-
Locator.focus()	-	-	-	-	-
Locator.press()	-	-	-	-	-
Locator.pressSequentially()	-	-	-	-	-
Locator.setInputFiles()	-	-	-	-	-

一些操作，例如 Locator.click() 支持 force 选项，该选项会禁用非必要的可靠性检查，例如向 Locator.click() 方法传递 truthy 的 force 值将不会检查目标元素是否实际接收到点击事件。

Playwright 包含自动重试断言，通过等待条件满足来消除不稳定性，这与操作前的自动等待类似。

断言	描述
assertThat(locator).isAttached()	元素已附加
assertThat(locator).isChecked()	复选框已选中
assertThat(locator).isDisabled()	元素已禁用
assertThat(locator).isEditable()	元素可编辑
assertThat(locator).isEmpty()	容器为空
assertThat(locator).isEnabled()	元素已启用
assertThat(locator).isFocused()	元素已聚焦
assertThat(locator).isHidden()	元素不可见
assertThat(locator).isInViewport()	元素与视口相交
assertThat(locator).isVisible()	元素可见
assertThat(locator).containsText()	元素包含文本
assertThat(locator).hasAttribute()	元素具有 DOM 属性
assertThat(locator).hasClass()	元素具有 class 属性
assertThat(locator).hasCount()	列表具有精确数量的子元素
assertThat(locator).hasCSS()	元素具有 CSS 属性
assertThat(locator).hasId()	元素具有 ID
assertThat(locator).hasJSProperty()	元素具有 JavaScript 属性
assertThat(locator).hasText()	元素匹配文本
assertThat(locator).hasValue()	输入框有值
assertThat(locator).hasValues()	选择框已选择选项
assertThat(page).hasTitle()	页面有标题
assertThat(page).hasURL()	页面有 URL
assertThat(response).isOK()	响应状态为 OK

在断言指南中了解更多信息。

当元素具有非空边界框且没有 visibility:hidden 计算样式时，该元素被认为是可见的。

请注意，根据此定义：

当元素在至少两个连续动画帧中保持相同的边界框时，该元素被认为是稳定的。

当元素未被禁用时，该元素被认为是启用的。

当以下情况时，元素被禁用：

它是带有 [disabled] 属性的 <button>、<select>、<input>、<textarea>、<option> 或 <optgroup>；
是 <button>、<select>、<input>、<textarea>、<option> 或 <optgroup>，它是带有 [disabled] 属性的 <fieldset> 的一部分；
它是带有 [aria-disabled=true] 属性的元素的后代。

当元素启用且未被只读时，该元素被认为是可编辑的。

当以下情况时，元素被只读：

当元素是操作点的指针事件的目标时，它被认为正在接收指针事件。例如，当点击点 (10;10) 时，Playwright 会检查是否有其他元素（通常是覆盖层）会 대신 捕获 (10;10) 处的点击。

例如，考虑这样一个场景：无论何时调用 Locator.click()，Playwright 都会点击 Sign Up 按钮