自动等待

简介

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

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

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

操作	可见	稳定	接收事件	启用	可编辑
locator.check()	是	是	是	是	-
locator.click()	是	是	是	是	-
locator.dblclick()	是	是	是	是	-
locator.set_checked()	是	是	是	是	-
locator.tap()	是	是	是	是	-
locator.uncheck()	是	是	是	是	-
locator.hover()	是	是	是	-	-
locator.drag_to()	是	是	是	-	-
locator.screenshot()	是	是	-	-	-
locator.fill()	是	-	-	是	是
locator.clear()	是	-	-	是	是
locator.select_option()	是	-	-	是	-
locator.select_text()	是	-	-	-	-
locator.scroll_into_view_if_needed()	-	是	-	-	-
locator.blur()	-	-	-	-	-
locator.dispatch_event()	-	-	-	-	-
locator.focus()	-	-	-	-	-
locator.press()	-	-	-	-	-
locator.press_sequentially()	-	-	-	-	-
locator.set_input_files()	-	-	-	-	-

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

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

断言	描述
expect(locator).to_be_attached()	元素已附加
expect(locator).to_be_checked()	复选框已选中
expect(locator).to_be_disabled()	元素已禁用
expect(locator).to_be_editable()	元素可编辑
expect(locator).to_be_empty()	容器为空
expect(locator).to_be_enabled()	元素已启用
expect(locator).to_be_focused()	元素已聚焦
expect(locator).to_be_hidden()	元素不可见
expect(locator).to_be_in_viewport()	元素与视口相交
expect(locator).to_be_visible()	元素可见
expect(locator).to_contain_text()	元素包含文本
expect(locator).to_have_attribute()	元素具有 DOM 属性
expect(locator).to_have_class()	元素具有 class 属性
expect(locator).to_have_count()	列表具有精确数量的子元素
expect(locator).to_have_css()	元素具有 CSS 属性
expect(locator).to_have_id()	元素具有 ID
expect(locator).to_have_js_property()	元素具有 JavaScript 属性
expect(locator).to_have_text()	元素匹配文本
expect(locator).to_have_value()	输入框有值
expect(locator).to_have_values()	选择框已选择选项
expect(page).to_have_title()	页面有标题
expect(page).to_have_url()	页面有 URL
expect(response).to_be_ok()	响应状态为 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 按钮