前言

UI选择器中，有findOne()、findOne(timeout)、findOnce()、findOnce(i)、find()、untilFind()几个函数接口。在开发的过程中，这几个接口有什么区别呢？

下面飞云结合Autojs Pro的官方文档，来分享一下。

UiSelector.findOne()返回值类型备注UiSelector返回选择器自身以便链式调用

根据当前的选择器所确定的筛选条件，对屏幕上的控件进行搜索，直到屏幕上出现满足条件的一个控件为止，并返回该控件。如果找不到控件，当屏幕内容发生变化时会重新寻找，直至找到。

需要注意的是，如果屏幕上一直没有出现所描述的控件，则该函数会阻塞，直至所描述的控件出现为止。因此此函数不会返回null。该函数本来应该命名为untilFindOne()，但由于历史遗留原因已经无法修改。如果想要只在屏幕上搜索一次而不是一直搜索，请使用findOnce()。

另外，如果屏幕上有多个满足条件的控件，findOne()采用深度优先搜索(DFS)，会返回该搜索算法找到的第一个控件。注意控件找到的顺序有时会起到作用。

一句话总结

findOne()函数会一直在屏幕上不停的寻找组件，直到找到。无返回值。

UiSelector.findOne(timeout)参数类型描述timeoutnumber搜索的超时时间，单位毫秒返回值类型备注UiSelector返回选择器自身以便链式调用

根据当前的选择器所确定的筛选条件，对屏幕上的控件进行搜索，直到屏幕上出现满足条件的一个控件为止，并返回该控件；如果在timeout毫秒的时间内没有找到符合条件的控件，则终止搜索并返回null。

该函数类似于不加参数的findOne()，只不过加上了时间限制。

官方示例：

一句话总结

findOne(timeout)函数在设定时间内寻找组件，返回null或返回找到的控件。

UiSelector.findOnce()返回值类型备注UiSelector返回选择器自身以便链式调用

根据当前的选择器所确定的筛选条件，对屏幕上的控件进行搜索，如果找到符合条件的控件则返回该控件；否则返回null。

一句话总结

findOnce()函数在屏幕上寻找组件，返回null或返回找到的控件。

UiSelector.findOnce(i)参数类型描述i{number}索引

根据当前的选择器所确定的筛选条件，对屏幕上的控件进行搜索，并返回第 i + 1 个符合条件的控件；如果没有找到符合条件的控件，或者符合条件的控件个数 < i, 则返回null。

注意这里的控件次序，是搜索算法深度优先搜索(DSF)决定的。

一句话总结

findOnce(i)函数在屏幕上寻找索引为 i + 1 的组件，返回null或返回找到的控件。

UiSelector.find()返回值类型备注UiCollection控件集合

根据当前的选择器所确定的筛选条件，对屏幕上的控件进行搜索，找到所有满足条件的控件集合并返回。这个搜索只进行一次，并不保证一定会找到，因而会出现返回的控件集合为空的情况。

不同于findOne()或者findOnce()只找到一个控件并返回一个控件，find()函数会找出所有满足条件的控件并返回一个控件集合。之后可以对控件集合进行操作。

可以通过empty()函数判断找到的是否为空。例如：

一句话总结

find()函数遍历屏幕上的组件，返回组件的集合。没招到则返回空集。

UiSelector.untilFind()返回值类型备注UiCollection控件集合

根据当前的选择器所确定的筛选条件，对屏幕上的控件进行搜索，直到找到至少一个满足条件的控件为止，并返回所有满足条件的控件集合。

该函数与find()函数的区别在于，该函数永远不会返回空集合；但是，如果屏幕上一直没有出现满足条件的控件，则该函数会保持阻塞。

一句话总结

untilFind()函数会一直在屏幕上不停的寻找组件，直到找到。找到后返回组件的集合。