browser_wait
Stabilize asynchronous flows by waiting for browser conditions: element visible/hidden, text appears, URL contains, load state, or fixed duration.
Instructions
Wait for the browser to reach a specified condition: element visible/hidden/detached, text appears, URL contains substring, load state, or a fixed duration. Used to stabilize asynchronous flows.
中文详情:
用途:等待真实浏览器达到指定状态(元素出现/隐藏、文本出现、URL 包含、加载状态、固定时间),稳定异步流程
何时使用:点击后等待 loading 消失时;异步请求后等待元素出现时;SPA 路由跳转后等待 URL 变化时;轮询前固定延迟时;动画完成后继续操作时
输出:{ ok: boolean, condition: string, elapsed: number, timeout: number, timedOut: boolean }
参数:
selector (string, 可选):要等待的 CSS 选择器,配合 state 使用
state (string, 可选):选择器状态,可选 attached/detached/visible/hidden,默认 visible
text (string, 可选):等待出现的页面文本
exact (boolean, 可选):文本是否精确匹配,默认 false
nth (number, 可选):当文本匹配多个元素时选择第几个,默认 0
urlContains (string, 可选):等待当前 URL 包含该字符串
loadState (string, 可选):等待加载状态,可选 load/domcontentloaded/networkidle
ms (number, 可选):固定等待毫秒数
timeout (number, 可选):超时时间,默认 10000ms
错误:超时抛出 'Timeout XXXXms exceeded';未提供任何等待条件抛出 'No wait condition provided'
示例:{"selector":".loading-spinner","state":"hidden","timeout":15000}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ms | No | 固定等待毫秒数 | |
| nth | No | 当文本匹配多个元素时选择第几个,默认 0 | |
| text | No | 要等待出现的页面文本 | |
| exact | No | 文本是否精确匹配,默认 false | |
| state | No | 选择器状态:attached/detached/visible/hidden,默认 visible | |
| timeout | No | 超时时间,默认 10000ms | |
| selector | No | 要等待的 CSS 选择器 | |
| loadState | No | 等待加载状态:load/domcontentloaded/networkidle | |
| urlContains | No | 等待当前 URL 包含该字符串 |