Locator 类

¥Locator class

定位器描述了定位对象并对其执行操作的策略。如果由于对象尚未准备好执行操作而导致操作失败，则会重试整个操作。自动检查成功操作的各种先决条件。

¥Locators describe a strategy of locating objects and performing an action on them. If the action fails because the object is not ready for the action, the whole operation is retried. Various preconditions for a successful action are checked automatically.

详情请参阅 https://pptr.nodejs.cn/guides/page-interactions#locators。

¥See https://pptr.nodejs.cn/guides/page-interactions#locators for details.

签名

¥Signature

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

Extends: EventEmitter<LocatorEvents>

属性

¥Properties

属性	修饰符	类型	描述
_	optional	T	用于名义上键入 定位器。
timeout	readonly	数字

方法

¥Methods

方法	修饰符	描述
click(this, options)		单击定位到的元素。
clone()		克隆定位器。
fill(this, value, options)		使用提供的值填写定位器标识的输入。输入的类型在运行时确定，并根据类型选择适当的填充方法。支持 contenteditable、select、textarea 和 input 元素。
filter(predicate)		创建根据定位值进行评估的期望。 如果期望不匹配，则定位器将重试。
hover(this, options)		悬停在定位元素上。
map(mapper)		使用提供的映射器映射定位器。
race(locators)	static	在多个定位器之间创建竞争，这些定位器试图并行定位元素，但确保只有一个元素接收操作。
scroll(this, options)		滚动定位到的元素。
setEnsureElementIsInTheViewport(this, value)		通过克隆当前定位器并指定定位器是否应将元素滚动到视口中（如果元素尚未在视口中）来创建一个新的定位器实例。
setTimeout(timeout)		通过克隆当前定位器并设置定位器操作的总超时来创建一个新的定位器实例。 通过 0 禁用超时。
setVisibility(this, visibility)		通过克隆当前定位器并将可见性属性更改为指定值来创建新的定位器实例。
setWaitForEnabled(this, value)		通过克隆当前定位器并指定是否等待输入元素在操作之前启用来创建新的定位器实例。适用于 click 和 fill 动作。
setWaitForStableBoundingBox(this, value)		通过克隆当前定位器并指定定位器是否必须等待元素的边界框在两个连续的动画帧之间相同来创建一个新的定位器实例。
wait(options)		等待定位器从页面获取序列化值。 请注意，这要求该值是 JSON 可序列化的。
waitHandle(options)		等待定位器从页面获取句柄。