类: UiSelector

更新: 2026/9/29 字数: 0 字 时长: 0 分钟

ui_object.UiSelector

控件选择器类。

目录

构造函数

• constructor

属性

• defaultUiObjectProvider

方法

• all
• atLeast
• atLeastOne
• atMost
• first
• firstOrNull
• findFirst
• findFirstOrNull
• from
• last
• lastOrNull
• findLast
• findLastOrNull
• maxretries
• takeAt
• takeAtOrNull
• findAt
• findAtOrNull
• timeout
• where

构造函数

constructor

• new UiSelector(): UiSelector

返回值

UiSelector

属性

defaultUiObjectProvider

静态 defaultUiObjectProvider: UiObjectProvider = ...

方法

all

• all(): Promise<UiObject[]>

获取全部符合条件的控件。

返回

Promise<UiObject[]> 返回控件列表的Promise

---

atLeast

• atLeast(min: number): UiSelector

设置最少返回的控件数量。

参数

名称	类型	描述
min	number	最小数量

返回

UiSelector 自身

---

atLeastOne

• atLeastOne(): UiSelector

设置最少返回一个的控件。

返回

UiSelector 自身

---

atMost

• atMost(max: number): UiSelector

设置最多返回的控件数量。

参数

名称	类型	描述
max	number	最大数量

返回

UiSelector 自身

---

first

• first(): Promise<undefined | UiObject>

获取第一个符合条件的控件。

返回

Promise<UiObject> 返回控件的Promise

---

firstOrNull

• firstOrNull(): Promise<undefined | UiObject>

获取第一个符合条件的控件。找不到返回null

返回

Promise<UiObject | null> 返回控件的Promise

---

findFirst

• findFirst(options?): Promise<UiObject>

....

参数

名称	类型	描述
options	FindOptions

返回

Promise<UiObject> 返回控件的Promise

---

findFirstOrNull

• findFirstOrNull(options?): Promise<UiObject | null>

....

参数

名称	类型	描述
options	FindOptions

返回

Promise<UiObject | null> 返回控件的Promise

---

from

• from(target: UiSelector | UiObject | UiObject[] | UiObjectProvider): UiSelector

设置选择控件的来源

参数

名称	类型	描述
target	UiSelector	UiObject

返回

UiSelector 自身

---

last

• last(): Promise<UiObject>

获取最后一个符合条件的控件。

返回

Promise<UiObject> 返回控件的Promise

---

lastOrNull

• lastOrNull(): Promise<undefined | Promise<undefined | UiObject>

获取最后一个符合条件的控件。

返回

Promise<undefined | UiObject> 返回控件的Promise

---

findLast

• findLast(options?): Promise<UiObject>

获取最后一个符合条件的控件。

参数

名称	类型	描述
options	FindOptions

返回

Promise<UiObject> 返回控件的Promise

---

findLastOrNull

• findLastOrNull(options?): Promise<undefined | UiObject>

获取最后一个符合条件的控件。

参数

名称	类型	描述
options	FindOptions

返回

Promise<undefined | UiObject> 返回控件的Promise

---

maxRetries

• maxRetries(max: number): UiSelector

设置查询重试次数。

参数

名称	类型	描述
max	number	重试次数

返回

UiSelector 自身

---

takeAt

• takeAt(i: number): Promise<UiObject>

获取第i个符合条件的控件。

参数

名称	类型	描述
i	number	第几个控件

返回

Promise<UiObject> 返回控件的Promise

---

takeAtOrNull

• takeAtOrNull(i: number): Promise<undefined | UiObject>

获取第i个符合条件的控件。

参数

名称	类型	描述
i	number	第几个控件

返回

Promise<undefined | UiObject> 返回控件的Promise

---

findAt

• findAt(i, options?): Promise<UiObject>

获取第i个符合条件的控件。

参数

名称	类型	描述
i	number	第几个控件
options	FindOptions

返回

Promise<UiObject> 返回控件的Promise

---

findAtOrNull

• findAtOrNull(i, options?): Promise<undefined | UiObject>

获取第i个符合条件的控件。

参数

名称	类型	描述
i	number	第几个控件
options	FindOptions

返回

Promise<undefined | UiObject> 返回控件的Promise

---

timeout

• timeout(timeout: number): UiSelector

设置查询超时时间。

参数

名称	类型	描述
timeout	number	超时时间

返回

UiSelector

---

where

• where(filter: SelectorQuery | UiObjectFilter): UiSelector

设置选择控件的条件。

参数

名称	类型	描述
filter	SelectorQuery	UiObjectFilter

返回

UiSelector 自身

---