Separate the commands with ; in one string, or pass them as an array in actions. Both return one result per command.

TP:basic is the template, T:Android version is the basic query that finds the label, and OY:1 is the expanded query that moves one node down to the value.

T:Main storage finds the label and OX:1 moves one node to the right, to the free size.

The query can be written inside the action. This is an optional query (OQ).

OX:-1 moves one node to the left of the title, to the left arrow, and click presses it.

The parser splits the query into template (TP:all), basic query (T:Main storage) and expanded query (VG:2&&XT:Audio&&OX:1), and runs them in that order to reach the Audio size.

With no query, the search uses the default template TP:more, so both commands return the same node IDs.

With delayed search (version 16), the search is performed at the moment getIds is called.

openApp does not use the ML, so no search is performed.

Before version 16 this ran the default TP:more search and then TP:reduced. Now only the TP:reduced search runs.

The first command saves the IDs of the digit buttons 1 to 9. The second passes them as elements, clicks each one with forEach(nsClick), and reads the result field.

TP:findText,/^[0-9]$/ returns only the digit keys. OX:1 from "3" points at "%", which is not in that list, so the result is null and lastError() gives the reason.

No template is given, so the default TP:more is used. It includes the "%" key, and the same offset from "3" now returns it.

getCount counts the current ML: 237 with the default TP:more. +TP:all replaces the ML, so the third count is also 242. The last three counts are for more, basic and reduced.

TP:reduced (a template), RN (a query filter) and reduceNodes (an action) perform similar node reduction in different places. This screen has 59 nodes, and each of the three brings the list down to 44.

TP:anyText returns all nodes that have text, and getText reads them. On the calculator this lists the title, the function keys, and every digit and operator.

A minimum and maximum of 1 keep only text that is exactly one character long, so 'Calculator', 'AC' and 'DEL' drop out of the list.

A regular expression matches the calculator's digit keys, which come back top to bottom. The second command matches one to four capital letters, and the wildcard *T returns the entries ending in T.

The first command reads the text of all five text fields. The second reads their hint text, which is supported from API 26. The third selects the field whose hint is "Email" and types an address into it.

TP:line,top,1 returns the nodes on the first line of the top region. Here that line has six nodes.

IX:0 picks the first node of the line, which is the left arrow. Clicking it goes back.

TP:line,bottom,-1 returns the last line of the bottom region, which has five nodes. The second command picks the editable node on that line and sets its text to Hello.

The bar has four tabs, so TP:appNavBar returns eight nodes: four icons, then four labels. A tab can be clicked by its label text or by its icon with IX:3, and BP:selected finds the selected tab.

The "+" icon covers both the icon row and the label row, so its node (21d62) appears twice. To get only the real labels, keep the nodes that have text, with T:/./ or filter(node.text).

In this app each tab is a single node that holds both the icon and the label, so the bar returns three nodes. A tab can still be clicked by position with IX:, not by text with T:.

With no position or query, the default position 0 is used. Here the result is five node IDs.

BP:scrollable matches all scrollable nodes on the screen. getNodes(B) returns the bounds and ID of each one.

Three actions in one call: open Android Settings, query the titles (android:id/title) inside the scrollable area, and read their text. The result has one entry per action.

The drawer opens as a popup among several scrollable areas. It can be selected by position (2) or by a query that matches something inside it (T:Sent). Both return the same 39 nodes.

With the template limited to the drawer, the query finds "Sent" and reads the node to its right, the count 505.

Without TP:scrollable the query is not limited to the popup, and the offset from "Sent" is not found.

Three ways to read the clock (R:.clock) of com.android.systemui. An optional query does not support P, so the third form selects the app with newQuery first.

The Home button belongs to the system UI, so the query selects that package and clicks R:.home.

The text on screen uses another Unicode hyphen, so T:*Wi-Fi* finds nothing. TN converts such hyphens and spaces to the keyboard characters and finds both entries.

BI:[-1,645] returns the nodes that a horizontal line at y = 645 touches, and IX:-1 picks the last one to click. BI:[0, 0, 1000, 1000] returns the nodes inside that rectangle.

The first query keeps the text fields that are clickable. The next two also require enabled; quotes around the list are optional.

getNodes(BP) returns every Boolean property of the matched node with its value.

BP:!enabled matches the next-period arrow when it is disabled and shown in gray. A loop through the periods can stop on this.

The arrow is disabled, so BP:enabled returns null and lastError() reports no match. The last command reads the labels in the same row as "Day" with TX.

Checkable nodes are usually clickable too. Of the 26 clickable nodes, 10 are checkable, so BP:clickable,!checkable leaves 16.

An empty call is the same as TP:more with getIds. T:/./, D:/./ and TD:/./ count the nodes that have text, a description, or either.

On the calculator, this matches one-character text (T:/^.$/) on buttons (C:.Button) whose resource ID matches .button_*.

A query with no match returns null, and lastError() shows the message. An unknown key such as X gives a different error.

The ML has nine nodes. IX:1 returns the second one and IX:-2 the second from the end.

OX:1 moves from the label to the value on its right.

OY:1 moves one node down from the label.

From the 5 key, OX:1 reaches 6 on its right and OY:-1 reaches 8 above it.

Starting from 0, going up and then two to the right lands on ×. Going two to the right and then up lands on −.

VG from "Start Charging" returns only two nodes. The first level does not reach the charging current.

scrollIntoView brings the option's title onto the screen. setChecked then moves from the title to its switch (OY:1&&OX:1) and turns it on.

If the title lands on the last line of the screen, the rest of the option may be out of view. Adding VG scrolls the whole option into view, and the switch is then found with BP:checkable.

VG:2 returns the whole charging group, 24 nodes. The first node encloses the group, which is useful with showOnScreen.

Inside the group, XT:/^[0-9]+ A$/ finds the text that is a number followed by " A".

Reads the value, clicks the arrow to its left (OX:-1), refreshes the nodes and reads it again: 32 A becomes 31 A.

repeat(5, …) clicks the left arrow five times, and the value goes from 32 A to 27 A.

From the 2 key, TX returns the six nodes that intersect it horizontally and TY the six that intersect it vertically.

The result field spans the full width of the screen. TX returns only the field itself, and TY returns 23 nodes.

The default query returns 242 nodes. With RN the count drops to 55.

The buttons already come back from top to bottom, so ST:Y and ST:YX change nothing. ST:X orders them by column, from left to right.

After VG selects the CPU group, XT:Cpu Cores or BQ:'T:Cpu Cores' finds the label inside it, and OX:1 reads the value.

With selector:allowBqAfterEq set to true (from version 14), a plain T: after VG runs as part of the EQ.

The query sets the Title field to the text, then moves to the All day switch and sets it to true. With no action given, the default getIds runs.

The switch expects true or false, so V:111 returns null and lastError() explains why.

The query has no match, so sendAai returns null and lastError() holds the message.

A misspelled action returns null, and lastError() names the invalid action.

The list holds the FindNode version, the current package name and the node count, in the order the actions ran.

lastError() gives the zero-based position of the failed action, here 1, with its error message.

echo returns its argument, which shows how each type is read. Strings may be unquoted or in single or double quotes. Arrays and objects can be indexed with [n] and .key, also when nested.

filter(node.class == '.Button') removes every node whose class is not .Button. The ML goes from 26 nodes to 20.

In the calculator only buttons are clickable, so node.isClickable leaves the same 20 nodes. The second command echoes the class and bounds of the first node.

With input set to "Hello", these three expressions show the strings that different quoting produces.

The built setText string is sent as the first action. click(OX:2) then presses the node two places to the right.

Inside backticks, ${input} inserts the variable. Quotes around it keep the text together if it contains a space.

The regular expression is stored in a variable and inserted into the query, which returns all the digits on the calculator.

${c()} and ${d()} call functions that return the class and the description to match. ${x} supplies the fields for getNodes.

disp() returns the complete getNodes action as a string, which is then inserted as the action.

A template literal lets the actions of a function span several lines. enterText sets the text, checks it, clicks the node two places to the right and sends Back.

aaix builds an action string from a name and its arguments. It was made for versions before 14; template literals now do the same job.

The strings built by aaix are passed as actions.

buildAction quotes each argument safely, so text with newlines or HTML can be sent without breaking the command.

Builds a setConfig action, sends it, and reads the value back with getConfig.

raw() inserts its text as is, so the JSON reaches echo as an object and not as a string.

The escaped characters are stored as plain text, as getText shows.

The app name "Domino's" contains a single quote, which is escaped.

echo returns the text with the escaped quote, commas and double quotes in place.

All three find "5". With no prefix the ML keeps its seven nodes. With + or * only "5" is left in the ML, as the second getText shows.

Without a prefix, each OX:1 starts from the same first node (7) and returns 8. With * the ML is replaced each time, so the second step moves on to 9.

+TP:anyText&&T:/[^0-9]/ builds a new ML of the 11 texts that are not digits. T:/^.$/ then picks the single-character ones from it.

"1" is not in the ML built by T:/[3-9]/. + finds it on the screen, while * searches only the ML and fails.

The condition can be a literal or a function such as exists. When it is false the third argument runs; here error stops with a message. The last command uses node.editable as the condition.

The isTrue function echoes how its argument is judged. 0, an empty string, false and null are false. Non-zero numbers, non-empty strings, arrays and objects are true.

echo shows the result of a comparison, which is an easy way to test one. The last three commands use comparisons inside if.

Arrays are equal when their elements match in the same order. Objects are equal when they have the same keys and values, in any order.

getAndroidVersion opens the settings and reads the version. ensureAndroidVersion compares it with its argument, 14 by default, and returns true or false.

The first two commands show the activity names for Gmail and Chrome. The last two save the current activity in a variable and open it again with openActivity.

Returns one bounds array for each matching node, along with the node IDs.

For "Checkbox 2", getBoolProp returns checkable and clickable. getAllBoolProps returns seven properties, including checked.

Returns each property together with the ID of the node that has it.

D:Sunday&&TX selects the row of seven day buttons, and getChecked returns the state of each.

No other element here has the class .CheckBox, so the first checkbox can serve as the reference node.

XBP:checked keeps only the checked nodes of the row, and getDescription returns their names.

The first two commands count all nodes and the nodes whose text contains a digit. A query with no match returns null with an error, while the same query given inside getCount returns 0.

The name comes back in retval.

getFocus selects the focused field and setText fills it. addQuery(OY:1) moves to the field below for the second setText.

getFuncRetval() with no argument is the last command of testEcho, so calling the function returns the output of all five echo commands.

The function passes its argument to getFuncRetval, so each call returns only the output of the command named.

The function opens the location screen, reads the address and goes back. getFuncRetval(getText) makes the address the result of the function.

An empty call returns the IDs of all 26 nodes. With an optional query, getIds returns only the four .Button nodes.

The result holds 567 apps. Only the first two are shown here.

The list is an ordinary array: its length matches count, and an entry can be read by index.

An invalid query sets the error. getLastError returns the same message, and after clearLastError it is empty.

The fields 'R,T' return the resource ID and the text of each node. The list is quoted because it contains a comma.

RI returns the type, minimum, maximum and current value of each slider.

IX:-1 picks the last slider, and BP returns all its Boolean properties.

The first command returns the package of the current app. The second returns the three packages on the screen.

The slider is at 41 on a scale from 0 to 100.

T:Controls&&TX returns the three nodes in the row. For each one, getUniqQuery builds a query that reaches it from the "Controls" text.

The search returns the two properties whose names contain ro.product.model. With =, only the value of that exact key comes back.

Four nodes return an array of text. A single node returns just the text.

After two fields are filled, getText returns the new content, with the password masked. getHintText still returns the original hints.

For text with colors, getTextFormats returns the plain text in retval and the formatting in html.

With two matching nodes, the result is an array with html and retval for each.

Each waits up to 10 seconds for the text to appear and then clicks it. newQuery and exists(+…) also change the ML; waitQuery does not.

The click opens a new window, but the ML still holds the nodes of the old one, so getText finds nothing.

refreshQuery after the click reads the new window, and getText then returns the Android version.

intersectX(T:3) finds the four nodes in the same row as 3.

intersectY also returns nodes with no visible text, such as the result field or a view group. They show here as {}.

addQuery(T:/.+/) keeps the nodes that have at least one character.

The text filter is given to getText directly.

filter(node.text != null) removes the nodes that have no text.

The digit keys are saved as calc. Later calls load them and click 2 and 3 without a new query. The result field shows 12, then 123.

With execTime:true the result includes the time spent in FindNode. Each full query takes about 160 ms, and loading the saved ML takes about 13 ms.

The ML was saved in the Play Store, but another app is now in the foreground, so load returns an error.

No ML was saved under this name.

TP:reduced returns 54 nodes, and reduceNodes on the default ML also leaves 54.

Both forms select the group around "Battery" and read the text in it that contains a percentage.

Both commands click the 5 key. nsClick does not wait for the screen to change.

The bounds of the 4 key are used to work out the centre of the key to its right, and nsClick(x, y) clicks there.

clickDown presses, sleep(3000) waits, and clickUp releases.

Six values in one call, each returned in its own retval.

listAndroidSettings() returns a list, and [0] and [-1] pick its first and last entries.

The text set in the field is an arithmetic expression, and echo returns its result, 192807. log returns true and writes the value to logcat.

push stores the ML of 227 nodes, filter(node.isEditable) reduces it to the single input field for setText, and pop restores the 227. The second command keeps only the nodes that have text.

node.text is short for node.text != null. The second filter then keeps only the numbers.

getText runs once on four nodes and returns an array. forEach(getText) runs four times and returns four results. In the last command, setChecked(true) runs on each day button, and true marks the ones that changed.

The battery shows either miles or a percentage. If the miles text exists, the function clicks it to change the mode, and then reads the percentage.

getLowPctg returns 20, the level at which charging is needed.

needCharge returns true when the battery percentage is at or below the threshold. At 79% it returns false.

return can return the comparison directly. After the threshold is redefined as 100, needCharge returns true.

add clicks the two digits with + and = on the calculator and reads the result.

equal compares the calculator's result with the arithmetic done by echo.

A false condition raises an AssertionError, with your own message if one is given. A true condition returns true.

The CPU usage is read, and after two seconds and a refresh it is read again: 29 becomes 78.

Clicks the 1 key on the calculator five times.

Clicks the arrow to the left of the current value.

The same click, repeated five times.

Reads the value, clicks five times, refreshes and reads again: 27 A becomes 22 A.

The first image is saved as a JPEG in the shared Pictures folder. After the settings change, the same command saves a PNG in Total Control's private folder.

IX:0 limits the image to the first node, the 7 key. The settings are changed first and checked with saveImageInfo.

VG selects the group around "Calls", so the image covers the whole bar.

The query matches the checkboxes, and the image covers all of them.

Scrolls up to 50 pages until "John" is found, then clicks it.

Finds the text that is a number followed by "miles" and reads it.

The first commands reopen the current activity by name. The others pass am start options: open a web page, launch YouTube, open the Wi-Fi settings and start an email.

Reads the slider's maximum and sets the value to half of it.

Loops over all the sliders in the sound settings, reads each maximum and sets half of it.

The fields are read with getText and getHintText, then chosen by their hint text. The last command appends " World" with a leading +.

A \n at the end of the text triggers Send in apps where Enter sends the message.

A template literal builds the emoji from code points and places them in the middle of the text.

By its text, by the template's hint argument, by HT, by its label, or by position with IX:1.

setNextText moves one field down (*OY:1) and sets its text.

The first field is set by position, and setNextText fills each field below it in turn.

getText shows the five values, with the password masked.

Returns true because the screen was scrolled. False would mean the node was already fully visible.

Swipes the "Alarm deleted" message to the right.

Both forms wait up to 20 seconds for the reset button to disappear.

Waits up to 30 seconds for the description under "Nasdaq" to change, then reads the new value.

If the battery percentage read from the system UI is below 10, error stops the call and lastError() shows the message.

The first command finds the resumed activity. The second is refused with "Permission denied". The third chains several commands and returns their combined output.

add clicks two digits with + and = on the calculator and reads the result. %1 and %2 default to 1 and 2.

3 and 4 replace %1 and %2. The function returns the value of its last command, getText.

With getFuncRetval() as the last command, the function returns the output of each command, as it did before version 17.

Both defaults are used, so it clicks 1 + 2 =.

%1 becomes 9 and %2 keeps its default of 2.

After funcDelete, funcExists returns false and calling add is an invalid action.

sendText finds the text field, sets the text and clicks the send button two nodes to the right. It can be called with literal text or with a variable.

findAndSend scrolls to a name, opens the chat, calls sendText and goes back.

getProduction opens mySolarEdge, waits for the screen, reads the current power and goes back twice. getFuncRetval(getText) returns the text.

The User Guide defines a JavaScript function getProduction() that calls the action and converts the text to watts. Here it returns 5890.

A successful install returns the package name, and an uninstall returns true. A missing file or an unknown package ends in a timeout error.

The list has 70 names.

With time measurement on, the first open takes about 3 seconds, opening it again when it is already in memory takes about 0.7 seconds, and a restart takes about 2.9 seconds.

A query and a timeout make openApp wait until "Lifetime" appears, here after about 13 seconds.

"manage applications" is converted to MANAGE_APPLICATIONS_SETTINGS.

If an editable field exists, its text is returned; otherwise null.

It does not stop the main action: echo(3) still runs, and return only adds true to the results.

The first return ends the function after two echo commands, so echo(3) never runs.

The key code for A is sent with the Shift meta state.

htmlSend puts both the plain text and the HTML on the clipboard and pastes them into the text field.

After this text is copied on the device, getClipData returns the HTML in retval and the plain text in text.

getClipData returns the data with its type. getClipText returns only the text.

buildAction quotes the text and the HTML safely before the action is sent.

With the default template set to reduced, getCount drops from 58 to 46. After unsetConfig it is 58 again.

Both names return the same number, 21.