Node Functions — On-Device Execution

Overview

Node module functions handle node operations
This module has no prefix; call functions directly
Due to iOS limitations, node fetching may be slow on some devices. After fetching nodes, lock them before searching
You can also tune node fetch parameters
Not suitable for pages such as video playback views

nodeAgent.setFetchNodeParam Set Node Fetch Parameters

Set base parameters for node fetching to reduce the number of nodes fetched and time spent
Requires EC iOS control center 5.0.0+
@param ext A map, e.g. {"visibleFilter":1}
visibleFilter 1 fetch nodes regardless of visible true/false; 2 fetch only visible=true nodes
labelFilter 1 fetch nodes regardless of label value; 2 fetch only nodes with a label value
boundsFilter 1 no filter; 2 filter nodes whose bounds x,y,w,h are all less than 0
maxDepth Node hierarchy depth to fetch; fewer levels are faster; recommended 1–500
maxChildCount Maximum child nodes to fetch; 0 means no limit
excludedAttributes Attributes to exclude, comma-separated, e.g. visible,selected,enable — can speed up fetching
@return {bool} true on success, false on failure

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

13
main();

nodeAgent.getNodeInfo Get Node Collection

Requires EC iOS control center 5.0.0+
@param selectors Node selector
@param timeout Timeout in milliseconds
@return {array} Collection of node objects

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

6
main();

nodeAgent.getOneNodeInfo Get Single Node

Requires EC iOS control center 5.0.0+
@param selectors Node selector
@param timeout Timeout in milliseconds
@return {NodeInfo} Node object

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

6
main();

nodeAgent.parent Get Parent Node

Get the parent of a node
@param nodeInfo NodeInfo node object
@return NodeInfo {NodeInfo object|null}

1
function main() {
2
 let n = nodeAgent.getOneNodeInfo(name("Other").name("文件"), 1000)
3
 if (n) {
4
 logd(JSON.stringify(n))
5
 let p = nodeAgent.parent(n)
6
 let allc = nodeAgent.getOneChildNodeInfo(p, name("小红书"), 10000);
7
 logd("getOneChildNodeInfo JSON " + JSON.stringify(allc))
8
 }
9
}
10

11
main()

nodeAgent.child Get Single Child Node

Get a single child node
Requires EC iOS control center 5.0.0+
@param nodeInfo NodeInfo node object
@param index Child node index
@return {NodeInfo} NodeInfo object or null

1
function main() {
2
 let n = nodeAgent.getOneNodeInfo(name("Other").name("文件"), 1000)
3
 if (n) {
4
 logd(JSON.stringify(n))
5
 let p = nodeAgent.parent(n)
6
 let allc = nodeAgent.child(p, 0);
7
 logd("child JSON " + JSON.stringify(allc))
8
 }
9
}
10

11

12
main()

nodeAgent.allChildren Get All Child Nodes

Get all child nodes
Requires EC iOS control center 5.0.0+
@param nodeInfo NodeInfo node object
@return {array} Collection of NodeInfo nodes

1
function main() {
2
 let n = nodeAgent.getOneNodeInfo(name("Other").name("文件"), 1000)
3
 if (n) {
4
 logd(JSON.stringify(n))
5
 logd(n.bounds.centerX())
6
 logd(n.bounds.centerY())
7
 let parentX = nodeAgent.parent(n);
8
 logd("parent JSON " + JSON.stringify(parentX))
9
 logd(JSON.stringify(nodeAgent.allChildren(parentX)));
10
 }
11

12
}
13

14
main()

nodeAgent.siblings Get All Sibling Nodes

Get all sibling nodes of the current node
Requires EC iOS control center 5.0.0+
@param nodeInfo NodeInfo node object
@return {array} Collection of NodeInfo nodes

1
function main() {
2
 let n = nodeAgent.getOneNodeInfo(name("Other").name("文件"), 1000)
3
 if (n) {
4
 logd(JSON.stringify(n))
5
 let allc = nodeAgent.siblings(n);
6
 logd("siblings JSON " + JSON.stringify(allc))
7
 if (allc) {
8
 for (let i = 0; i < allc.length; i++) {
9
 logd("siblings " + JSON.stringify(allc[i]))
10
 }
11
 }
12
 }
13
}
14

15

16
main()

nodeAgent.previousSiblings Get Previous Sibling Nodes

Get sibling nodes before the current node
Requires EC iOS control center 5.0.0+
@param nodeInfo NodeInfo node object
@return {array} Collection of NodeInfo nodes

1
function main() {
2
 let n = nodeAgent.getOneNodeInfo(name("Other").name("文件"), 1000)
3
 if (n) {
4
 logd(JSON.stringify(n))
5
 let allc = nodeAgent.previousSiblings(n);
6
 logd("previousSiblings JSON " + JSON.stringify(allc))
7
 if (allc) {
8
 for (let i = 0; i < allc.length; i++) {
9
 logd("previousSiblings " + JSON.stringify(allc[i]))
10
 }
11
 }
12
 }
13
}
14

15
main()

nodeAgent.nextSiblings Get Next Sibling Nodes

Get sibling nodes after the current node
Requires EC iOS control center 5.0.0+
@param nodeInfo NodeInfo node object
@return {array} Collection of NodeInfo nodes

1
function main() {
2
 let n = nodeAgent.getOneNodeInfo(name("Other").name("文件"), 1000)
3
 if (n) {
4
 logd(JSON.stringify(n))
5
 let allc = nodeAgent.nextSiblings(n);
6
 logd("nextSiblings JSON " + JSON.stringify(allc))
7
 if (allc) {
8
 for (let i = 0; i < allc.length; i++) {
9
 logd("nextSiblings " + JSON.stringify(allc[i]))
10
 }
11
 }
12
 }
13
}
14

15
main()

nodeAgent.getOneChildNodeInfo Cascade Filter Single Child Node

Cascade-filter a single child node
Requires EC iOS control center 5.0.0+
@param nodeInfo NodeInfo node object
@param selectors Node selector
@param timeout Timeout in milliseconds
@return {NodeInfo} NodeInfo node object

1
function main() {
2
 let n = nodeAgent.getOneNodeInfo(name("Other").name("文件"), 1000)
3
 if (n) {
4
 logd(JSON.stringify(n))
5
 let p = nodeAgent.parent(n)
6
 let allc = nodeAgent.getOneChildNodeInfo(p, name("小红书"), 10000);
7
 logd("getOneChildNodeInfo JSON " + JSON.stringify(allc))
8
 }
9
}
10

11
main()

nodeAgent.getChildNodeInfo Cascade Filter Multiple Child Nodes

Cascade-filter multiple child nodes
Requires EC iOS control center 5.0.0+
@param nodeInfo NodeInfo node object
@param selectors Node selector
@param timeout Timeout in milliseconds
@return {array} Collection of NodeInfo nodes

1
function main() {
2
 let n = nodeAgent.getOneNodeInfo(name("Other").name("文件"), 1000)
3
 if (n) {
4
 logd(JSON.stringify(n))
5
 let p = nodeAgent.parent(n)
6
 let allc = nodeAgent.getChildNodeInfo(p, name("小红书"), 10000);
7
 logd("getChildNodeInfo JSON " + JSON.stringify(allc))
8
 }
9
}
10

11
main()

nodeAgent.lockNode Lock Nodes

Lock nodes
Requires EC iOS control center 5.0.0+

1
function main() {
2
 nodeAgent.lockNode()
3
 for (let i = 0; i < 100; i++) {
4
 sleep(1000)
5
 let n = nodeAgent.getOneNodeInfo(name("Other").name("文件"), 1000)
6
 if (n) {
7
 logd(JSON.stringify(n))
8
 let p = nodeAgent.parent(n)
9
 let allc = nodeAgent.getChildNodeInfo(p, name("小红书"), 10000);
10
 logd("getOneChildNodeInfo JSON " + JSON.stringify(allc))
11
 } else {
12
 logd("no node info")
13
 }
14
 }
15
 nodeAgent.releaseNode()
16
}
17

18
main()

nodeAgent.releaseNode Release Nodes

Release locked nodes
Requires EC iOS control center 5.0.0+

1
function main() {
2
 nodeAgent.lockNode()
3
 for (let i = 0; i < 100; i++) {
4
 sleep(1000)
5
 let n = nodeAgent.getOneNodeInfo(name("Other").name("文件"), 1000)
6
 if (n) {
7
 logd(JSON.stringify(n))
8
 let p = nodeAgent.parent(n)
9
 let allc = nodeAgent.getChildNodeInfo(p, name("小红书"), 10000);
10
 logd("getOneChildNodeInfo JSON " + JSON.stringify(allc))
11
 } else {
12
 logd("no node info")
13
 }
14
 }
15
 nodeAgent.releaseNode()
16
}
17

18
main()

nodeAgent.dumpXml Export Nodes

Export node XML (node matching runs on the device)
Requires EC iOS control center 5.0.0+
@return {string} Node XML string

1
function main() {
2
 logd(nodeAgent.dumpXml())
3
}
4

5
main()