跳至主要内容
版本:22.5.0

定位器类

定位器描述了定位对象并对它们执行操作的策略。如果操作失败,因为对象尚未准备好进行操作,则重试整个操作。将自动检查成功执行操作的各种先决条件。

签名:

export declare abstract class Locator<T> extends EventEmitter<LocatorEvents>

扩展: EventEmitter<LocatorEvents>

属性

属性修饰符类型描述
_可选T用于标称类型化 Locator
超时只读数字

方法

方法修饰符描述
click(this, options)
clone()克隆定位器。
fill(this, value, options)使用提供的值填充定位器识别的输入。输入类型在运行时确定,并根据类型选择适当的填充方法。支持 contenteditable、选择器、输入。
filter(predicate)

创建针对已定位值评估的预期。

如果预期不匹配,则定位器将重试。

hover(this, options)
map(mapper)使用提供的映射器映射定位器。
race(locators)静态在多个定位器之间创建竞争,但确保仅有一个定位器起作用。
scroll(this, options)
setEnsureElementIsInTheViewport(this, value)
setTimeout(timeout)
setVisibility(this, visibility)
setWaitForEnabled(this, value)
setWaitForStableBoundingBox(this, value)
wait(options)

等待定位器从页面获取序列化的值。

请注意,这要求该值可被 JSON 序列化。

waitHandle(options)等待定位器从页面获取句柄。