自动等待
介绍
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 选项，该选项禁用非必要的可操作性检查。例如，将真值 force 传递给 locator.click() 方法将不会检查目标元素是否实际接收点击事件。
断言
Playwright 包含自动重试断言，它通过等待直到条件满足来消除不稳定性，这与操作前的自动等待类似。
| 断言 | 描述 |
|---|---|
| expect(locator).toBeAttached() | 元素已附加 |
| expect(locator).toBeChecked() | 复选框已选中 |
| expect(locator).toBeDisabled() | 元素已禁用 |
| expect(locator).toBeEditable() | 元素可编辑 |
| expect(locator).toBeEmpty() | 容器为空 |
| expect(locator).toBeEnabled() | 元素已启用 |
| expect(locator).toBeFocused() | 元素已聚焦 |
| expect(locator).toBeHidden() | 元素不可见 |
| expect(locator).toBeInViewport() | 元素与视口相交 |
| expect(locator).toBeVisible() | 元素可见 |
| expect(locator).toContainText() | 元素包含文本 |
| expect(locator).toHaveAttribute() | 元素具有 DOM 属性 |
| expect(locator).toHaveClass() | 元素具有 class 属性 |
| expect(locator).toHaveCount() | 列表具有精确的子元素数量 |
| expect(locator).toHaveCSS() | 元素具有 CSS 属性 |
| expect(locator).toHaveId() | 元素具有 ID |
| expect(locator).toHaveJSProperty() | 元素具有 JavaScript 属性 |
| expect(locator).toHaveText() | 元素匹配文本 |
| expect(locator).toHaveValue() | 输入框具有值 |
| expect(locator).toHaveValues() | 选择框已选择选项 |
| expect(page).toHaveTitle() | 页面具有标题 |
| expect(page).toHaveURL() | 页面具有 URL |
| expect(response).toBeOK() | 响应具有 OK 状态 |
在断言指南中了解更多信息。
可见
当元素具有非空的 bounding box 并且没有 visibility:hidden 计算样式时，该元素被认为是可见的。
请注意，根据此定义
- 零尺寸的元素不被认为是可见的。
display:none的元素不被认为是可见的。opacity:0的元素是被认为是可见的。
稳定
当元素在至少两个连续的动画帧中保持相同的 bounding box 时，该元素被认为是稳定的。
已启用
当元素未被禁用时，该元素被认为是已启用的。
当元素满足以下条件时，被禁用：
- 它是带有
[disabled]属性的<button>、<select>、<input>、<textarea>、<option>或<optgroup>； - 它是
<button>、<select>、<input>、<textarea>、<option>或<optgroup>，并且是带有[disabled]属性的<fieldset>的一部分； - 它是带有
[aria-disabled=true]属性的元素的后代。
可编辑
当元素是已启用的并且不是只读的时，该元素被认为是可编辑的。
当元素满足以下条件时，是只读的：
- 它是带有
[readonly]属性的<select>、<input>或<textarea>； - 它具有
[aria-readonly=true]属性和一个 支持它的 aria role。
接收事件
当元素是操作点处指针事件的命中目标时，该元素被认为正在接收指针事件。例如，当点击点 (10;10) 时，Playwright 会检查是否有一些其他元素（通常是覆盖层）会改为捕获 (10;10) 处的点击。
例如，考虑这样一种情况：无论何时调用 locator.click()，Playwright 都会点击 Sign Up 按钮
- 页面正在检查用户名是否唯一，并且
Sign Up按钮被禁用； - 与服务器检查后，禁用的
Sign Up按钮被替换为另一个现在已启用的按钮。