可在一个字符串中用 ; 分隔命令，也可通过 actions 传入命令数组。两种方式都会为每条命令返回一个结果。

TP:basic 是模板，T:Android version 是查找标签的基本查询，OY:1 是向下偏移一个节点以获取对应值的扩展查询。

T:Main storage 查找标签，OX:1 向右偏移一个节点，获取剩余空间大小。

查询也可以写在操作内部，这称为可选查询（OQ）。

OX:-1 从标题向左偏移一个节点，定位左箭头，再由 click 点击它。

解析器将查询拆分为模板（TP:all）、基本查询（T:Main storage）和扩展查询（VG:2&&XT:Audio&&OX:1），并按此顺序执行，获取音频占用空间。

未指定查询时，搜索使用默认模板 TP:more，因此两条命令返回相同的节点 ID。

使用延迟搜索机制（第 16 版）时，搜索在调用 getIds 的时刻执行。

openApp 不使用 ML，因此不会执行搜索。

第 16 版之前会先执行默认的 TP:more 搜索，再执行 TP:reduced。现在只执行 TP:reduced 搜索。

第一条命令保存数字按钮 1 到 9 的 ID。第二条命令通过 elements 传入这些 ID，用 forEach(nsClick) 逐个点击，然后读取结果框。

TP:findText,/^[0-9]$/ 仅返回数字按键。从“3”执行 OX:1 会指向“%”，而该节点不在列表中，因此返回 null，lastError() 给出原因。

未指定模板，因此使用默认的 TP:more。其中包含“%”按键，从“3”执行相同偏移即可返回该节点。

getCount 统计当前 ML 的节点数：默认 TP:more 返回 237 个。+TP:all 替换 ML，因此第三次统计也为 242。最后三次分别统计 more、basic 和 reduced。

TP:reduced（模板）、RN（查询过滤器）和 reduceNodes（操作）在不同阶段执行类似的节点精简。该界面有 59 个节点，三种方式都将列表精简为 44 个。

TP:anyText 返回所有包含文字的节点，getText 读取其文字。在计算器中，这会列出标题、功能键、所有数字和运算符。

将最小和最大长度都设为 1，仅保留一个字符的文字，因此“Calculator”“AC”和“DEL”会被排除。

正则表达式匹配计算器的数字按键，结果按从上到下的顺序返回。第二条命令匹配一到四个大写字母，通配符 *T 返回以 T 结尾的项。

第一条命令读取全部五个文本框的文字。第二条读取提示文字，该功能从 API 26 开始支持。第三条选中提示文字为“Email”的文本框并输入地址。

TP:line,top,1 返回顶部区域第一行的节点。本例中该行有六个节点。

IX:0 选取该行的第一个节点，即左箭头。点击后返回上一页。

TP:line,bottom,-1 返回底部区域的最后一行，其中有五个节点。第二条命令选取该行的可编辑节点，将文字设为 Hello。

导航栏有四个标签，因此 TP:appNavBar 返回八个节点：四个图标和四个标签。可通过标签文字或使用 IX:3 点击图标，BP:selected 用于查找已选中的标签。

“+”图标跨越图标行和标签行，因此其节点（21d62）出现两次。要仅获取实际标签，可用 T:/./ 或 filter(node.text) 保留包含文字的节点。

此应用中每个标签由一个同时包含图标和文字的节点组成，因此导航栏返回三个节点。仍可用 IX: 按位置点击标签，但不能用 T: 按文字点击。

未指定位置或查询时，使用默认位置 0。本例返回五个节点 ID。

BP:scrollable 匹配屏幕上的所有可滚动节点。getNodes(B) 返回每个节点的边界和 ID。

一次调用执行三个操作：打开 Android 设置，在可滚动区域中查询标题（android:id/title），并读取文字。每个操作对应一个结果项。

抽屉作为弹出窗口打开，屏幕中有多个可滚动区域。可按位置（2）或通过匹配区域内元素的查询（T:Sent）选中它。两种方式都返回相同的 39 个节点。

将模板限定为抽屉后，查询找到“Sent”，并读取其右侧节点，即数量 505。

不使用 TP:scrollable 时，查询范围不限于弹出窗口，无法找到从“Sent”偏移的节点。

读取 com.android.systemui 中时钟（R:.clock）的三种方式。可选查询不支持 P，因此第三种方式先通过 newQuery 选择应用。

主屏幕按钮属于系统界面，因此查询选择该包并点击 R:.home。

屏幕文字使用另一种 Unicode 连字符，因此 T:*Wi-Fi* 无法匹配。TN 将这些连字符和空格转换为键盘字符后，可找到两项。

BI:[-1,645] 返回与 y = 645 的水平线相交的节点，IX:-1 选取最后一个并点击。BI:[0, 0, 1000, 1000] 返回指定矩形内的节点。

第一个查询保留可点击的文本框。后两个查询还要求 enabled；属性列表外的引号可省略。

getNodes(BP) 返回匹配节点的所有布尔属性及其值。

BP:!enabled 匹配处于禁用状态、显示为灰色的下一周期箭头。遍历周期的循环可据此停止。

箭头处于禁用状态，因此 BP:enabled 返回 null，lastError() 报告无匹配。最后一条命令使用 TX 读取与“Day”同一行的标签。

可勾选节点通常也可点击。26 个可点击节点中有 10 个可勾选，因此 BP:clickable,!checkable 剩余 16 个节点。

空调用相当于使用 getIds 的 TP:more。T:/./、D:/./ 和 TD:/./ 分别统计包含文字、描述或两者之一的节点。

在计算器中，这会匹配文字为单个字符（T:/^.$/）、类型为按钮（C:.Button）且资源 ID 匹配 .button_* 的节点。

无匹配的查询返回 null，lastError() 显示错误信息。使用未知键（如 X）会产生另一种错误。

ML 中有九个节点。IX:1 返回第二个，IX:-2 返回倒数第二个。

OX:1 从标签偏移到其右侧的值。

OY:1 从标签向下偏移一个节点。

从按键 5 开始，OX:1 移动到右侧的 6，OY:-1 移动到上方的 8。

从 0 开始，先向上再向右移动两格，会到达 ×；先向右移动两格再向上，会到达 −。

从“Start Charging”执行 VG 仅返回两个节点，第一级组不包含充电电流。

scrollIntoView 将选项标题滚动到屏幕内，setChecked 再从标题移动到开关（OY:1&&OX:1）并打开它。

标题若位于屏幕最后一行，选项的其他部分可能仍在屏幕外。添加 VG 可将整个选项滚动到屏幕内，再用 BP:checkable 查找开关。

VG:2 返回整个充电组，共 24 个节点。第一个节点包含整个组，适合配合 showOnScreen 使用。

在组内，XT:/^[0-9]+ A$/ 查找数字后跟“ A”的文字。

读取值，点击左侧箭头（OX:-1），刷新节点后再次读取：32 A 变为 31 A。

repeat(5, …) 点击左箭头五次，电流从 32 A 变为 27 A。

从按键 2 开始，TX 返回与其水平相交的六个节点，TY 返回垂直相交的六个节点。

结果框横跨整个屏幕宽度。TX 仅返回结果框本身，TY 返回 23 个节点。

默认查询返回 242 个节点，使用 RN 后减少为 55 个。

按钮原本就按从上到下的顺序返回，因此 ST:Y 和 ST:YX 不改变顺序。ST:X 按列从左到右排序。

VG 选中 CPU 组后，XT:Cpu Cores 或 BQ:'T:Cpu Cores' 查找组内标签，OX:1 读取对应值。

将 selector:allowBqAfterEq 设为 true（第 14 版起支持）后，VG 后面的普通 T: 会作为 EQ 的一部分执行。

查询先为 Title 文本框设置文字，再移动到 All day 开关并设为 true。未指定操作时执行默认的 getIds。

开关需要 true 或 false，因此 V:111 返回 null，lastError() 说明原因。

查询没有匹配结果，因此 sendAai 返回 null，lastError() 保存错误信息。

操作名称拼写错误会返回 null，lastError() 指出无效的操作。

列表按执行顺序包含 FindNode 版本、当前包名和节点数。

lastError() 给出失败操作从 0 开始的位置（本例为 1），以及对应错误信息。

echo 返回传入的参数，用于展示各类型的解析方式。字符串可不加引号，也可使用单引号或双引号。数组和对象可通过 [n]、.key 访问元素，嵌套结构也支持。

filter(node.class == '.Button') 移除类名不是 .Button 的节点，ML 从 26 个节点减少为 20 个。

计算器中只有按钮可点击，因此 node.isClickable 同样保留 20 个节点。第二条命令回显第一个节点的类名和边界。

将 input 设为“Hello”后，这三个表达式展示不同引号写法生成的字符串。

构建的 setText 字符串作为第一个操作发送，然后由 click(OX:2) 点击右侧相隔两个位置的节点。

反引号中的 ${input} 会插入变量。变量外的引号可确保包含空格的文字作为一个整体处理。

将正则表达式保存在变量中并插入查询，返回计算器上的全部数字。

${c()} 和 ${d()} 调用函数，返回要匹配的类名和描述。${x} 为 getNodes 提供要返回的字段。

disp() 以字符串形式返回完整的 getNodes 操作，再将它作为操作传入。

模板字符串可将函数的操作写成多行。enterText 设置文字、检查文字、点击右侧相隔两个位置的节点，然后发送返回键。

aaix 根据名称和参数构建操作字符串，主要用于第 14 版之前的版本；现在模板字符串也能完成同样的工作。

由 aaix 构建的字符串作为操作传入。

buildAction 安全地为每个参数添加引号，因此包含换行或 HTML 的文字也能发送，不会破坏命令格式。

构建并发送 setConfig 操作，再通过 getConfig 读取设置值。

raw() 原样插入文字，使 JSON 以对象而非字符串形式传给 echo。

转义后的字符作为普通文字保存，可通过 getText 查看。

应用名称“Domino’s”中包含单引号，需要转义。

echo 返回文字，其中保留转义后的引号、逗号和双引号。

三种形式都找到“5”。无前缀时 ML 保留七个节点；使用 + 或 * 后，ML 仅保留“5”，可通过第二次 getText 查看。

无前缀时，每次 OX:1 都从同一个首节点（7）开始并返回 8。使用 * 时，每次都会替换 ML，因此第二步继续移动到 9。

+TP:anyText&&T:/[^0-9]/ 建立新的 ML，其中有 11 个非数字文字节点。T:/^.$/ 再从中选取单字符节点。

T:/[3-9]/ 建立的 ML 不包含“1”。+ 可以在屏幕上找到它，* 仅搜索 ML，因此失败。

条件可以是字面量或 exists 等函数。为 false 时执行第三个参数，本例中 error 停止执行并给出信息。最后一条命令将 node.editable 作为条件。

isTrue 函数回显参数的真假判定。0、空字符串、false 和 null 为假；非零数、非空字符串、数组和对象为真。

echo 显示比较结果，便于测试。最后三条命令在 if 内使用比较表达式。

数组的元素及顺序相同时判定为相等。对象的键和值相同时判定为相等，与键的顺序无关。

getAndroidVersion 打开设置并读取版本。ensureAndroidVersion 将其与传入参数比较（默认为 14），返回 true 或 false。

前两条命令显示 Gmail 和 Chrome 的 Activity 名称。后两条将当前 Activity 保存到变量，再通过 openActivity 重新打开。

为每个匹配节点返回一个边界数组及其节点 ID。

对于“Checkbox 2”，getBoolProp 返回 checkable 和 clickable；getAllBoolProps 返回七个属性，包括 checked。

返回每个属性及拥有该属性的节点 ID。

D:Sunday&&TX 选择七个日期按钮所在的行，getChecked 返回每个按钮的状态。

该界面中没有其他元素使用类名 .CheckBox，因此可将第一个复选框作为参考节点。

XBP:checked 仅保留该行中已勾选的节点，getDescription 返回它们的名称。

前两条命令统计全部节点，以及文字包含数字的节点。无匹配的 query 返回 null 并报错；将相同查询写在 getCount 内则返回 0。

名称通过 retval 返回。

getFocus 选择获得焦点的文本框，setText 填写它。addQuery(OY:1) 移动到下方文本框，供第二次 setText 使用。

不带参数的 getFuncRetval() 是 testEcho 的最后一条命令，因此调用函数会返回五条 echo 命令的全部输出。

函数将参数传给 getFuncRetval，每次调用仅返回指定命令的输出。

函数打开位置信息界面，读取地址后返回。getFuncRetval(getText) 将地址作为函数结果。

空调用返回全部 26 个节点的 ID。使用可选查询时，getIds 仅返回四个 .Button 节点。

结果包含 567 个应用，此处仅展示前两个。

列表是普通数组，其长度与 count 相同，可按索引读取元素。

无效查询会设置错误信息。getLastError 返回相同信息，调用 clearLastError 后变为空字符串。

字段 'R,T' 返回各节点的资源 ID 和文字。由于字段列表包含逗号，需要加引号。

RI 返回每个滑块的类型、最小值、最大值和当前值。

IX:-1 选择最后一个滑块，BP 返回其全部布尔属性。

第一条命令返回当前应用包名，第二条返回屏幕上三个应用的包名。

滑块范围为 0 到 100，当前值为 41。

T:Controls&&TX 返回该行的三个节点。对于每个节点，getUniqQuery 构建从“Controls”文字定位到它的查询。

搜索返回名称中包含 ro.product.model 的两个属性。使用 = 时，仅返回该键的值。

四个节点返回文字数组，单个节点只返回文字本身。

填写两个文本框后，getText 返回新内容，密码以掩码显示；getHintText 仍返回原来的提示文字。

对于带颜色的文字，getTextFormats 在 retval 中返回纯文本，在 html 中返回格式信息。

匹配两个节点时，结果为数组，每个元素包含 html 和 retval。

每种方式最多等待 10 秒，文字出现后点击。newQuery 和 exists(+…) 还会改变 ML，waitQuery 不会。

点击打开新窗口，但 ML 仍保留旧窗口节点，因此 getText 没有匹配结果。

点击后调用 refreshQuery 读取新窗口，随后 getText 返回 Android 版本。

intersectX(T:3) 找到与按键 3 位于同一行的四个节点。

intersectY 也会返回没有可见文字的节点，例如结果框或视图组，此处显示为 {}。

addQuery(T:/.+/) 保留至少包含一个字符的节点。

直接将文字过滤条件传给 getText。

filter(node.text != null) 移除没有文字的节点。

将数字按键保存为 calc。后续调用直接加载，并点击 2 和 3，无需重新查询。结果框先显示 12，再显示 123。

使用 execTime:true 时，结果包含 FindNode 的耗时。每次完整查询约需 160 ms，加载已保存的 ML 约需 13 ms。

ML 在 Play 商店中保存，但当前前台是另一个应用，因此 load 返回错误。

没有使用该名称保存过 ML。

TP:reduced 返回 54 个节点，对默认 ML 执行 reduceNodes 后也剩余 54 个。

两种形式都会选中“Battery”所在的组，并读取其中包含百分比的文字。

两条命令都点击按键 5。nsClick 不等待屏幕变化。

根据按键 4 的边界计算其右侧按键的中心，再由 nsClick(x, y) 点击该位置。

clickDown 按下，sleep(3000) 等待，clickUp 松开。

一次调用传入六个值，每个值分别通过对应的 retval 返回。

listAndroidSettings() 返回列表，[0] 和 [-1] 分别选取首项和末项。

文本框中的文字是算术表达式，echo 返回计算结果 192807。log 返回 true，并将值写入 logcat。

push 保存包含 227 个节点的 ML，filter(node.isEditable) 将其精简为一个供 setText 使用的输入框，pop 恢复全部 227 个节点。第二条命令仅保留有文字的节点。

node.text 是 node.text != null 的简写，第二个过滤器再仅保留数字。

getText 一次处理四个节点并返回数组；forEach(getText) 执行四次并返回四个结果。最后一条命令对每个日期按钮执行 setChecked(true)，true 表示状态已改变。

电池显示为英里数或百分比。若存在英里数文字，函数点击它切换模式，再读取百分比。

getLowPctg 返回 20，即需要充电的阈值。

电池百分比小于或等于阈值时，needCharge 返回 true；79% 时返回 false。

return 可直接返回比较结果。将阈值重新定义为 100 后，needCharge 返回 true。

add 在计算器上点击两个数字及 +、=，然后读取结果。

equal 将计算器结果与 echo 的算术结果进行比较。

条件为 false 时抛出 AssertionError；若提供了自定义信息，则包含该信息。条件为 true 时返回 true。

读取 CPU 使用率，等待两秒并执行 refresh 后再次读取：29 变为 78。

点击计算器的按键 1 五次。

点击电流值左侧的箭头。

重复同一次点击五次。

读取值，点击五次，刷新后再次读取：27 A 变为 22 A。

第一张图片以 JPEG 格式保存到共享 Pictures 文件夹。修改设置后，同一命令将 PNG 图片保存到 Total Control 的私有文件夹。

IX:0 将图片范围限定为第一个节点，即按键 7。先修改设置，再通过 saveImageInfo 检查。

VG 选择“Calls”所在的组，因此图片包含整个导航栏。

查询匹配复选框，图片包含全部匹配项。

最多滚动 50 页，直到找到“John”，然后点击。

查找数字后跟“miles”的文字，并读取它。

前几条命令按名称重新打开当前 Activity。其他命令传入 am start 选项：打开网页、启动 YouTube、打开 Wi-Fi 设置和新建邮件。

读取滑块最大值，并将当前值设为其一半。

遍历声音设置中的全部滑块，读取各自最大值并设为一半。

通过 getText 和 getHintText 读取文本框，再按提示文字选择。最后一条命令通过开头的 + 追加“ World”。

对于按 Enter 发送消息的应用，在文字末尾添加 \n 可触发发送。

模板字符串根据码点构建表情符号，并插入文字中间。

可通过文字、模板的提示参数、HT、标签，或使用 IX:1 按位置定位。

setNextText 向下移动一个文本框（*OY:1），并设置其文字。

按位置填写第一个文本框，再通过 setNextText 依次填写下方各文本框。

getText 显示五个值，密码以掩码显示。

由于屏幕发生滚动，返回 true；若返回 false，则表示节点原本已完全可见。

向右滑动“Alarm deleted”消息。

两种形式都最多等待 20 秒，直到重置按钮消失。

最多等待 30 秒，直到“Nasdaq”下方的描述变化，然后读取新值。

从系统界面读取的电池百分比低于 10 时，error 停止调用，lastError() 显示错误信息。

第一条命令查找已恢复的 Activity。第二条被拒绝并显示“Permission denied”。第三条串联多条命令，返回组合后的输出。

add 在计算器上点击两个数字及 +、=，然后读取结果。%1 和 %2 默认为 1 和 2。

3 和 4 替换 %1 和 %2。函数返回最后一条命令 getText 的值。

将 getFuncRetval() 作为最后一条命令时，函数返回各命令的输出，与第 17 版之前的行为相同。

使用两个默认值，因此点击 1 + 2 =。

%1 变为 9，%2 保留默认值 2。

执行 funcDelete 后，funcExists 返回 false；再调用 add 会报无效操作。

sendText 找到文本框，设置文字，再点击右侧相隔两个节点的发送按钮。可用文字字面量或变量调用。

findAndSend 滚动到指定姓名，打开聊天，调用 sendText 后返回。

getProduction 打开 mySolarEdge，等待界面，读取当前功率，再返回两次。getFuncRetval(getText) 返回文字。

用户指南定义了 JavaScript 函数 getProduction()，用于调用该操作并将文字转换为瓦特数。本例返回 5890。

安装成功返回包名，卸载成功返回 true。文件不存在或包名未知时，会以超时错误结束。

列表包含 70 个名称。

启用耗时统计后，首次打开约需 3 秒；应用已在内存中时再次打开约需 0.7 秒；重启约需 2.9 秒。

查询和超时参数使 openApp 等待“Lifetime”出现，本例约需 13 秒。

“manage applications”会转换为 MANAGE_APPLICATIONS_SETTINGS。

若存在可编辑文本框，则返回其文字，否则返回 null。

不会停止主操作：echo(3) 仍会执行，return 只向结果中添加 true。

第一个 return 在两条 echo 命令后结束函数，因此 echo(3) 不会执行。

发送 A 的键码，并附带 Shift 修饰键状态。

htmlSend 将纯文本和 HTML 都放入剪贴板，并粘贴到文本框。

在设备上复制该文字后，getClipData 在 retval 中返回 HTML，在 text 中返回纯文本。

getClipData 返回数据及类型，getClipText 仅返回文字。

buildAction 在发送操作前安全地为文字和 HTML 添加引号。

将默认模板设为 reduced 后，getCount 从 58 降为 46。执行 unsetConfig 后恢复为 58。

两个名称都返回同一个版本号：21。