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
Some pages may be unsuitable (e.g. video playback pages)

Three ways to lock nodes:

Function	Scenario	Description
`lockNode`	USB direct	Pull XML from phone over USB and lock into PC cache
`lockNodeFromXml`	WiFi + Aux	Inject external XML (e.g. `auxEvent.agentDumpXml()`) into PC cache and lock (9.39.0+)
`releaseNode`	General	Release lock; next fetch uses refreshed UI

For the full WiFi workflow see lockNodeFromXml; object form: agentEvent.lockNodeFromXml(xml) — see Proxy Events.

setFetchNodeParam Set Node Fetch Parameters

Set base parameters for node fetching to reduce node count and time cost
Supported: EC iOS control center 3.0.0+
@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–500
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({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": "visible,selected,enable,accessible"})
4
 logd(data);
5
}
6

7
main();

lockNode Lock Nodes

Pull node XML from phone over USB and lock into PC cache; UI refresh won’t update cached tree until releaseNode
Supported: EC iOS control center 3.0.0+
Use with setFetchNodeParam to narrow fetch scope and improve speed

1
function main() {
2
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2"});
3
 releaseNode();
4
 lockNode();
5

6
 let nd = label("Settings").getOneNodeInfo(1000);
7
 logd("node: {}", nd ? JSON.stringify(nd) : "null");
8
}
9

10
main();

lockNodeFromXml Lock Node from XML

Inject external XML into PC node cache and lock; use with auxEvent.agentDumpXml, then continue with selectors (label().getNodeInfo(), etc.)
Requires EC iOS control center 9.39.0+
Object form: agentEvent.lockNodeFromXml(xml) — see Proxy Events — lockNodeFromXml
@param xml XML string (e.g. return value of auxEvent.agentDumpXml())
@return {bool} true on success, false on failure

1
function main() {
2
 auxEvent.ensureWifiSession("");
3
 auxEvent.agentStartEnv();
4
 auxEvent.agentSetFetchNodeParam({
5
 labelFilter: "2",
6
 maxDepth: "20",
7
 visibleFilter: "2"
8
 });
9

10
 let xml = auxEvent.agentDumpXml();
11
 logd("xml length: {}", xml ? xml.length : 0);
12
 if (!xml) {
13
 logd("agentDumpXml failed");
14
 return;
15
 }
16

17
 releaseNode();
18
 let ok = lockNodeFromXml(xml);
19
 logd("lockNodeFromXml: {}", ok);
20
 if (!ok) {
21
 return;
22
 }
23

24
 let nd = label("Settings").getOneNodeInfo(0);
25
 logd("node: {}", nd ? JSON.stringify(nd) : "null");
26
}
27

28
main();

releaseNode Release Nodes

Release node lock; after release, getNodeInfo etc. re-fetch XML from current UI
Supported: EC iOS control center 3.0.0+
Use together with lockNode and lockNodeFromXml

1
function main() {
2
 setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2"});
3
 releaseNode();
4
 lockNode();
5

6
 let nd = label("Settings").getOneNodeInfo(1000);
7
 logd("locked: {}", nd ? JSON.stringify(nd) : "null");
8

9
 releaseNode();
10
 logd("Node lock released");
11
}
12

13
main();

getNodeInfo Get Node Collection

timeout Timeout in milliseconds
Supported: EC iOS control center 3.0.0+
@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
Supported: EC iOS control center 3.0.0+
@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
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
 // 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()

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 7.7.0+
@param value e.g. //node[@value=‘易点云测’] selects nodes whose value equals 易点云测 (EasyClick Cloud Test)

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

8
main();

idMatch id Regex Attribute Match

Regex match on id attribute
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
 // 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()

label label Exact Attribute Match

Exact match on label attribute
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
 // 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
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
 // 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
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
 // 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
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
 // 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
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
 // 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
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
 // 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
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
 // 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
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
 // 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
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
 // 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
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
 // 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
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
 // 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
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
 // 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
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
 // 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
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
 // 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
Supported: EC iOS control center 3.0.0+
@return {bool} true on success, false on failure

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

14
}
15

16
main()

clickRandom Click Node Randomly

Click a random point within the node bounds
Supported: EC iOS control center 3.0.0+
@return {bool} true on success, false on failure

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

14
}
15

16
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
Supported: EC iOS control center 3.0.0+
@return {NodeInfo} Node object

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

15

16
main()

child Get Single Child Node

Get a single child node
Supported: EC iOS control center 3.0.0+
@param index Child node index
@return {NodeInfo} NodeInfo object or null

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

15

16
main()

allChildren Get All Child Nodes

Get all child nodes
Supported: EC iOS control center 3.0.0+
@return {array} Array of NodeInfo nodes

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

15

16
main()

siblings Get All Sibling Nodes

All sibling nodes of the current node
Supported: EC iOS control center 3.0.0+
@return {array} Array of NodeInfo nodes

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

15
main()

previousSiblings Get Previous Sibling Nodes

Sibling nodes before the current node
Supported: EC iOS control center 3.0.0+
@return {array} Array of NodeInfo nodes

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

15
main()

nextSiblings Get Next Sibling Nodes

Sibling nodes after the current node
Supported: EC iOS control center 3.0.0+
@return {array} Array of NodeInfo nodes

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

15
main()