Node Functions

Overview

Node module functions are used for node operations
This module has no prefix; call functions directly
Due to iOS limitations, node fetch may be slow on some devices. After fetching nodes, lock them before searching
You can also use setFetchNodeParam to tune node fetching
Previously unsuitable pages (e.g. video playback) are supported since 7.1.0

setFetchNodeParam Set Node Fetch Parameters

Set base parameters for node fetching to reduce node count and time cost
@param ext A map, e.g. {"visibleFilter":1}
visibleFilter: 1 = fetch regardless of visible; 2 = only visible=true nodes
labelFilter: 1 = fetch regardless of label; 2 = only nodes with a label value
boundsFilter: 1 = no filter; 2 = filter nodes whose bounds x,y,w,h are all < 0
maxDepth: Node tree depth to fetch; lower is faster; recommended 1–50
maxChildCount: Max child nodes to fetch; 0 = unlimited
excludedAttributes: Comma-separated attributes to exclude for faster fetching, e.g. visible,selected,enable
@return {bool} true on success, false on failure

1
function main() {
2
 // Run once at the start of the script
3
 var data = setFetchNodeParam({
4
 "labelFilter": "2",
5
 "boundsFilter": "1",
6
 "maxDepth": "20",
7
 "visibleFilter": "2",
8
 "excludedAttributes": ""
9
 })
10
 logd(data);
11
}
12

13
main();

createSession Create Automation Session

Create an automation session (call before fetching nodes; may improve fetch speed)
@param bundleId Target app bundleId; pass "" to use last appLaunch or current foreground app
@return {boolean} true on success, false on failure

1
function main() {
2
 var data = appLaunch("com.ownbook.notes")
3
 logd(createSession("com.ownbook.notes"));
4
}
5

6
main();

getNodeInfo Get Node Collection

timeout Timeout in milliseconds
@return {array} Array of node objects

1
function main() {
2
 var data = label("aaa").getNodeInfo(1000);
3
 logd(JSON.stringify(data));
4
}
5

6
main();

getOneNodeInfo Get Single Node

timeout Timeout in milliseconds
@return {NodeInfo} Node object

1
function main() {
2
 var data = label("aaa").getOneNodeInfo(1000);
3
 logd(JSON.stringify(data));
4
}
5

6
main();

Selector Functions

id id Exact Attribute Match

Exact match on id attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 // Run once at the start of the script
13
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
14
 // Release previous lock first
15
 releaseNode();
16
 // Lock new node data
17
 lockNode();
18
 // Begin node search
19
 // Search by id
20
 let nd = id("Settings").getOneNodeInfo(1000)
21
 if (nd) {
22
 console.log("id search node info {} ", JSON.stringify(nd))
23
 // Click if found
24
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
25
 logd("click it: {}", c)
26
 } else {
27
 console.log("id search: node not found ")
28
 }
29
 // Search by regex
30
 nd = idMatch(".*Settings.*").getNodeInfo(1000)
31
 if (nd) {
32
 console.log("idMatch search node info {} ", JSON.stringify(nd))
33
 } else {
34
 console.log("idMatch search: node not found ")
35
 }
36
 // Release previous lock first
37
 releaseNode();
38
}
39

40
function autoServiceStart(time) {
41
 for (let i = 0; i < time; i++) {
42
 if (isServiceOk()) {
43
 return true;
44
 }
45
 let started = startEnv();
46
 logd("Service start attempt " + (i + 1) + " result: " + started);
47
 if (isServiceOk()) {
48
 return true;
49
 }
50
 }
51
 return isServiceOk();
52
}
53

54
main()

idMatch id Regex Attribute Match

Regex match on id attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by id
19
 let nd = id("Settings").getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log("id search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log("id search: node not found ")
27
 }
28
 // Search by regex
29
 nd = idMatch(".*Settings.*").getNodeInfo(1000)
30
 if (nd) {
31
 console.log("idMatch search node info {} ", JSON.stringify(nd))
32
 } else {
33
 console.log("idMatch search: node not found ")
34
 }
35
 // Release previous lock first
36
 releaseNode();
37
}
38

39
function autoServiceStart(time) {
40
 for (let i = 0; i < time; i++) {
41
 if (isServiceOk()) {
42
 return true;
43
 }
44
 let started = startEnv();
45
 logd("Service start attempt " + (i + 1) + " result: " + started);
46
 if (isServiceOk()) {
47
 return true;
48
 }
49
 }
50
 return isServiceOk();
51
}
52

53
main()

xpath Selection

XPath selector; see https://www.jianshu.com/p/c205334122b3 and https://www.runoob.com/xpath/xpath-syntax.html
Use the IDE node panel to inspect xpath attributes and test xpath
Requires EC 4.7.0+
@param value e.g. //node[@label=‘易点云测’] selects nodes whose label equals 易点云测 (EasyClick Cloud Test)

1
function main() {
2
 // Get selector object
3
 var selector = xpath("//node[@label='易点云测']");
4
 let n = selector.getNodeInfo(1000);
5
 logd(JSON.stringify(n))
6
}
7

8
main();

label label Exact Attribute Match

Exact match on label attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by label
19
 let nd = label("Settings").getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log("label search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log("label search: node not found ")
27
 }
28
 // Search by regex
29
 nd = labelMatch(".*Settings.*").getNodeInfo(1000)
30
 if (nd) {
31
 console.log("labelMatch search node info {} ", JSON.stringify(nd))
32
 } else {
33
 console.log("labelMatch search: node not found ")
34
 }
35
 // Release previous lock first
36
 releaseNode();
37
}
38

39
function autoServiceStart(time) {
40
 for (let i = 0; i < time; i++) {
41
 if (isServiceOk()) {
42
 return true;
43
 }
44
 let started = startEnv();
45
 logd("Service start attempt " + (i + 1) + " result: " + started);
46
 if (isServiceOk()) {
47
 return true;
48
 }
49
 }
50
 return isServiceOk();
51
}
52

53
main()

labelMatch label Regex Attribute Match

Regex match on label attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by label
19
 let nd = label("Settings").getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log("label search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log("label search: node not found ")
27
 }
28
 // Search by regex
29
 nd = labelMatch(".*Settings.*").getNodeInfo(1000)
30
 if (nd) {
31
 console.log("labelMatch search node info {} ", JSON.stringify(nd))
32
 } else {
33
 console.log("labelMatch search: node not found ")
34
 }
35
 // Release previous lock first
36
 releaseNode();
37
}
38

39
function autoServiceStart(time) {
40
 for (let i = 0; i < time; i++) {
41
 if (isServiceOk()) {
42
 return true;
43
 }
44
 let started = startEnv();
45
 logd("Service start attempt " + (i + 1) + " result: " + started);
46
 if (isServiceOk()) {
47
 return true;
48
 }
49
 }
50
 return isServiceOk();
51
}
52

53
main()

name name Exact Attribute Match

Exact match on name attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by name
19
 let nd = name("Settings").getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log("name search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log("name search: node not found ")
27
 }
28
 // Search by name regex
29
 nd = nameMatch(".*Settings.*").getNodeInfo(1000)
30
 if (nd) {
31
 console.log("nameMatch search node info {} ", JSON.stringify(nd))
32
 } else {
33
 console.log("nameMatch search: node not found ")
34
 }
35
 // Release previous lock first
36
 releaseNode();
37
}
38

39
function autoServiceStart(time) {
40
 for (let i = 0; i < time; i++) {
41
 if (isServiceOk()) {
42
 return true;
43
 }
44
 let started = startEnv();
45
 logd("Service start attempt " + (i + 1) + " result: " + started);
46
 if (isServiceOk()) {
47
 return true;
48
 }
49
 }
50
 return isServiceOk();
51
}
52

53
main()

nameMatch name Regex Attribute Match

Regex match on name attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by name
19
 let nd = name("Settings").getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log("name search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log("name search: node not found ")
27
 }
28
 // Search by name regex
29
 nd = nameMatch(".*Settings.*").getNodeInfo(1000)
30
 if (nd) {
31
 console.log("nameMatch search node info {} ", JSON.stringify(nd))
32
 } else {
33
 console.log("nameMatch search: node not found ")
34
 }
35
 // Release previous lock first
36
 releaseNode();
37
}
38

39
function autoServiceStart(time) {
40
 for (let i = 0; i < time; i++) {
41
 if (isServiceOk()) {
42
 return true;
43
 }
44
 let started = startEnv();
45
 logd("Service start attempt " + (i + 1) + " result: " + started);
46
 if (isServiceOk()) {
47
 return true;
48
 }
49
 }
50
 return isServiceOk();
51
}
52

53
main()

type type Exact Attribute Match

Exact match on type attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by type
19
 let nd = type("XCUIElementTypeOther").getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log("type search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log("label search: node not found ")
27
 }
28
 // Search by type regex
29
 nd = typeMatch(".*XCUIElement.*").getNodeInfo(1000)
30
 if (nd) {
31
 console.log("typeMatch search node info {} ", JSON.stringify(nd))
32
 } else {
33
 console.log("typeMatch search: node not found ")
34
 }
35
 // Release previous lock first
36
 releaseNode();
37
}
38

39
function autoServiceStart(time) {
40
 for (let i = 0; i < time; i++) {
41
 if (isServiceOk()) {
42
 return true;
43
 }
44
 let started = startEnv();
45
 logd("Service start attempt " + (i + 1) + " result: " + started);
46
 if (isServiceOk()) {
47
 return true;
48
 }
49
 }
50
 return isServiceOk();
51
}
52

53
main()

typeMatch type Regex Attribute Match

Regex match on type attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by type
19
 let nd = type("XCUIElementTypeOther").getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log("type search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log("label search: node not found ")
27
 }
28
 // Search by type regex
29
 nd = typeMatch(".*XCUIElementTypeOther.*").getNodeInfo(1000)
30
 if (nd) {
31
 console.log("typeMatch search node info {} ", JSON.stringify(nd))
32
 } else {
33
 console.log("ltypeMatch search: node not found ")
34
 }
35
 // Release previous lock first
36
 releaseNode();
37
}
38

39
function autoServiceStart(time) {
40
 for (let i = 0; i < time; i++) {
41
 if (isServiceOk()) {
42
 return true;
43
 }
44
 let started = startEnv();
45
 logd("Service start attempt " + (i + 1) + " result: " + started);
46
 if (isServiceOk()) {
47
 return true;
48
 }
49
 }
50
 return isServiceOk();
51
}
52

53
main()

value value Exact Attribute Match

Exact match on value attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by value
19
 let nd = value("XCUIElementTypeOther").getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log("value search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log("value search: node not found ")
27
 }
28
 // Search by type regex
29
 nd = valueMatch(".*XCUIElementTypeOther.*").getNodeInfo(1000)
30
 if (nd) {
31
 console.log("valueMatch search node info {} ", JSON.stringify(nd))
32
 } else {
33
 console.log("valueMatch search: node not found ")
34
 }
35
 // Release previous lock first
36
 releaseNode();
37
}
38

39
function autoServiceStart(time) {
40
 for (let i = 0; i < time; i++) {
41
 if (isServiceOk()) {
42
 return true;
43
 }
44
 let started = startEnv();
45
 logd("Service start attempt " + (i + 1) + " result: " + started);
46
 if (isServiceOk()) {
47
 return true;
48
 }
49
 }
50
 return isServiceOk();
51
}
52

53
main()

valueMatch value Regex Attribute Match

Regex match on value attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by value
19
 let nd = value("XCUIElementTypeOther").getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log("value search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log("value search: node not found ")
27
 }
28
 // Search by type regex
29
 nd = valueMatch(".*XCUIElementTypeOther.*").getNodeInfo(1000)
30
 if (nd) {
31
 console.log("valueMatch search node info {} ", JSON.stringify(nd))
32
 } else {
33
 console.log("valueMatch search: node not found ")
34
 }
35
 // Release previous lock first
36
 releaseNode();
37
}
38

39
function autoServiceStart(time) {
40
 for (let i = 0; i < time; i++) {
41
 if (isServiceOk()) {
42
 return true;
43
 }
44
 let started = startEnv();
45
 logd("Service start attempt " + (i + 1) + " result: " + started);
46
 if (isServiceOk()) {
47
 return true;
48
 }
49
 }
50
 return isServiceOk();
51
}
52

53
main()

enable enable Exact Attribute Match

Exact match on enable attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by enable and accessible
19
 let nd = enable(true).accessible(true).getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log(" search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log(" search: node not found ")
27
 }
28
 // Release previous lock first
29
 releaseNode();
30
}
31

32
function autoServiceStart(time) {
33
 for (let i = 0; i < time; i++) {
34
 if (isServiceOk()) {
35
 return true;
36
 }
37
 let started = startEnv();
38
 logd("Service start attempt " + (i + 1) + " result: " + started);
39
 if (isServiceOk()) {
40
 return true;
41
 }
42
 }
43
 return isServiceOk();
44
}
45

46
main()

accessible accessible Exact Attribute Match

Exact match on accessible attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by enabled and accessible
19
 let nd = enabled(true).accessible(true).getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log(" search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log(" search: node not found ")
27
 }
28
 // Release previous lock first
29
 releaseNode();
30
}
31

32
function autoServiceStart(time) {
33
 for (let i = 0; i < time; i++) {
34
 if (isServiceOk()) {
35
 return true;
36
 }
37
 let started = startEnv();
38
 logd("Service start attempt " + (i + 1) + " result: " + started);
39
 if (isServiceOk()) {
40
 return true;
41
 }
42
 }
43
 return isServiceOk();
44
}
45

46
main()

visible visible Exact Attribute Match

Exact match on visible attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by visible
19
 let nd = visible(true).getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log(" search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log(" search: node not found ")
27
 }
28
 // Release previous lock first
29
 releaseNode();
30
}
31

32
function autoServiceStart(time) {
33
 for (let i = 0; i < time; i++) {
34
 if (isServiceOk()) {
35
 return true;
36
 }
37
 let started = startEnv();
38
 logd("Service start attempt " + (i + 1) + " result: " + started);
39
 if (isServiceOk()) {
40
 return true;
41
 }
42
 }
43
 return isServiceOk();
44
}
45

46
main()

index index Exact Attribute Match

Exact match on index attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by index
19
 let nd = index(1).getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log(" search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log(" search: node not found ")
27
 }
28
 // Release previous lock first
29
 releaseNode();
30
}
31

32
function autoServiceStart(time) {
33
 for (let i = 0; i < time; i++) {
34
 if (isServiceOk()) {
35
 return true;
36
 }
37
 let started = startEnv();
38
 logd("Service start attempt " + (i + 1) + " result: " + started);
39
 if (isServiceOk()) {
40
 return true;
41
 }
42
 }
43
 return isServiceOk();
44
}
45

46
main()

depth depth Exact Attribute Match

Exact match on depth attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by depth
19
 let nd = depth(1).getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log(" search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log(" search: node not found ")
27
 }
28
 // Release previous lock first
29
 releaseNode();
30
}
31

32
function autoServiceStart(time) {
33
 for (let i = 0; i < time; i++) {
34
 if (isServiceOk()) {
35
 return true;
36
 }
37
 let started = startEnv();
38
 logd("Service start attempt " + (i + 1) + " result: " + started);
39
 if (isServiceOk()) {
40
 return true;
41
 }
42
 }
43
 return isServiceOk();
44
}
45

46
main()

selected selected Exact Attribute Match

Exact match on selected attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by selected
19
 let nd = selected(true).getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log(" search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log(" search: node not found ")
27
 }
28
 // Release previous lock first
29
 releaseNode();
30
}
31

32
function autoServiceStart(time) {
33
 for (let i = 0; i < time; i++) {
34
 if (isServiceOk()) {
35
 return true;
36
 }
37
 let started = startEnv();
38
 logd("Service start attempt " + (i + 1) + " result: " + started);
39
 if (isServiceOk()) {
40
 return true;
41
 }
42
 }
43
 return isServiceOk();
44
}
45

46
main()

childcount childcount Exact Attribute Match

Exact match on childcount attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by childCount
19
 let nd = childCount(2).getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log(" search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log(" search: node not found ")
27
 }
28
 // Release previous lock first
29
 releaseNode();
30
}
31

32
function autoServiceStart(time) {
33
 for (let i = 0; i < time; i++) {
34
 if (isServiceOk()) {
35
 return true;
36
 }
37
 let started = startEnv();
38
 logd("Service start attempt " + (i + 1) + " result: " + started);
39
 if (isServiceOk()) {
40
 return true;
41
 }
42
 }
43
 return isServiceOk();
44
}
45

46
main()

bounds bounds Bounds Range Match

Bounds range match on bounds attribute

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Search by bounds
19
 let nd = bounds(100, 100, 300, 300).getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log(" search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log(" search: node not found ")
27
 }
28
 // Release previous lock first
29
 releaseNode();
30
}
31

32
function autoServiceStart(time) {
33
 for (let i = 0; i < time; i++) {
34
 if (isServiceOk()) {
35
 return true;
36
 }
37
 let started = startEnv();
38
 logd("Service start attempt " + (i + 1) + " result: " + started);
39
 if (isServiceOk()) {
40
 return true;
41
 }
42
 }
43
 return isServiceOk();
44
}
45

46
main()

Click Node

clickCenter Click Node Center

Click the center of the node
@return {bool} true on success, false on failure

1
function main() {
2
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "70", "visibleFilter": "2", "excludedAttributes": "visible,2"})
3
 let node = name("Maps").getOneNodeInfo(10000)
4
 logd(JSON.stringify(node))
5
 if (node) {
6
 logd(node.clickCenter())
7
 }
8

9
}
10

11
main()

clickRandom Click Node Randomly

Click a random point within the node bounds
@return {bool} true on success, false on failure

1
function main() {
2
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "70", "visibleFilter": "2", "excludedAttributes": "visible,2"})
3
 let node = name("Maps").getOneNodeInfo(10000)
4
 logd(JSON.stringify(node))
5
 if (node) {
6
 logd(node.clickRandom())
7
 }
8
}
9

10
main()

Multi-Attribute Cascaded Query

Supported: EC iOS control center 3.0.0+

1
function main() {
2
 // Write your code here
3
 logd("Checking automation environment...")
4
 // If automation service is OK
5
 if (!autoServiceStart(3)) {
6
 logd("automation service failed to start; cannot run script")
7
 exit();
8
 return;
9
 }
10
 logd("Starting script...")
11
 // Set node fetch parameters; see setFetchNodeParam for details
12
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
 // Release previous lock first
14
 releaseNode();
15
 // Lock new node data
16
 lockNode();
17
 // Begin node search
18
 // Cascaded attribute search
19
 let nd = labelMatch(".*1.*").enabled(true).accessible(true).bounds(100, 100, 300, 300).getOneNodeInfo(1000)
20
 if (nd) {
21
 console.log(" search node info {} ", JSON.stringify(nd))
22
 // Click if found
23
 let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
 logd("click it: {}", c)
25
 } else {
26
 console.log(" search: node not found ")
27
 }
28
 // Release previous lock first
29
 releaseNode();
30
}
31

32
function autoServiceStart(time) {
33
 for (let i = 0; i < time; i++) {
34
 if (isServiceOk()) {
35
 return true;
36
 }
37
 let started = startEnv();
38
 logd("Service start attempt " + (i + 1) + " result: " + started);
39
 if (isServiceOk()) {
40
 return true;
41
 }
42
 }
43
 return isServiceOk();
44
}
45

46
main()

Node Cascading Operations

parent Query Node Parent

Query the node’s parent
@return {NodeInfo} Node object

1
function main() {
2

3
 // Begin node search
4
 let nd = labelMatch(".*1.*").getOneNodeInfo(1000)
5
 if (nd) {
6
 console.log(" search node info {} ", JSON.stringify(nd))
7
 let parent = nd.parent()
8
 console.log(" search parent {} ", JSON.stringify(parent))
9
 } else {
10
 console.log(" search: node not found ")
11
 }
12
 // Release previous lock first
13
 releaseNode();
14
}
15

16

17
main()

child Get Single Child Node

Get a single child node
@param index Child node index
@return {NodeInfo} NodeInfo object or null

1
function main() {
2

3
 // Begin node search
4
 let nd = labelMatch(".*1.*").getOneNodeInfo(1000)
5
 if (nd) {
6
 console.log(" search node info {} ", JSON.stringify(nd))
7
 let child1 = nd.child(0)
8
 console.log(" search child {} ", JSON.stringify(child1))
9
 } else {
10
 console.log(" search: node not found ")
11
 }
12
 // Release previous lock first
13
 releaseNode();
14
}
15

16

17
main()

allChildren Get All Child Nodes

Get all child nodes
@return {array} Array of NodeInfo nodes

1
function main() {
2

3
 // Begin node search
4
 let nd = labelMatch(".*1.*").getOneNodeInfo(1000)
5
 if (nd) {
6
 console.log(" search node info {} ", JSON.stringify(nd))
7
 let allChildren = nd.allChildren()
8
 console.log(" search allChildren {} ", JSON.stringify(allChildren))
9
 } else {
10
 console.log(" search: node not found ")
11
 }
12
 // Release previous lock first
13
 releaseNode();
14
}
15

16

17
main()

siblings Get All Sibling Nodes

All sibling nodes of the current node
@return {array} Array of NodeInfo nodes

1
function main() {
2

3
 // Begin node search
4
 let nd = labelMatch(".*1.*").getOneNodeInfo(1000)
5
 if (nd) {
6
 console.log(" search node info {} ", JSON.stringify(nd))
7
 let siblings = nd.siblings()
8
 console.log(" search siblings {} ", JSON.stringify(siblings))
9
 } else {
10
 console.log(" search: node not found ")
11
 }
12
 // Release previous lock first
13
 releaseNode();
14
}
15

16

17
main()

previousSiblings Get Previous Sibling Nodes

Sibling nodes before the current node
@return {array} Array of NodeInfo nodes

1
function main() {
2

3
 // Begin node search
4
 let nd = labelMatch(".*1.*").getOneNodeInfo(1000)
5
 if (nd) {
6
 console.log(" search node info {} ", JSON.stringify(nd))
7
 let previousSiblings = nd.previousSiblings()
8
 console.log(" search previousSiblings {} ", JSON.stringify(previousSiblings))
9
 } else {
10
 console.log(" search: node not found ")
11
 }
12
 // Release previous lock first
13
 releaseNode();
14
}
15

16

17
main()

nextSiblings Get Next Sibling Nodes

Sibling nodes after the current node
@return {array} Array of NodeInfo nodes

1
function main() {
2

3
 // Begin node search
4
 let nd = labelMatch(".*1.*").getOneNodeInfo(1000)
5
 if (nd) {
6
 console.log(" search node info {} ", JSON.stringify(nd))
7
 let nextSiblings = nd.nextSiblings()
8
 console.log(" search nextSiblings {} ", JSON.stringify(nextSiblings))
9
 } else {
10
 console.log(" search: node not found ")
11
 }
12
 // Release previous lock first
13
 releaseNode();
14
}
15

16
main()