节点函数

说明

节点模块函数主要是跟节点操作相关联
该模块没有模块前缀，可以直接调用函数
由于IOS的限制，可能部分机器获取节点过慢，建议获取节点后进行锁定节点后，在进行查找
也可以使用设置节点获取参数的方式进行
不适合的页面：比如适配播放页面等

锁定节点三种方式：

函数	适用场景	说明
`lockNode`	USB 直连	经 USB 从手机拉 XML 并锁定到 PC 缓存
`lockNodeFromXml`	WiFi + Aux	将 `auxEvent.agentDumpXml()` 等外部 XML 注入 PC 缓存并锁定（适配 9.39.0+）
`releaseNode`	通用	释放锁定，恢复为界面刷新后重新拉取

WiFi 场景完整流程见 lockNodeFromXml；对象形式可用 agentEvent.lockNodeFromXml(xml)，见代理事件。

setFetchNodeParam 设置节点参数

设置获取节点的基础参数，这个参数可以有效减少获取节点的数量和消耗的时间
支持版本: EC iOS 中控 3.0.0+
@param ext 是一个map，例如 {"visibleFilter":1}
visibleFilter 1 代表不管visible是true还是false都获取，2 代表只获取 visible=true的节点
labelFilter 1 代表不管label是否有值都获取，2 代表只获取label有值的节点
boundsFilter 1 代表不过滤 2 bounds 区域属性x,y,w,h都小于0就被过滤
maxDepth 代表要获取节点的层级，越少速度越快，建议 1 - 500
maxChildCount 最大获取子节点数量，0代表不限制
excludedAttributes 代表要过滤的属性，用英文逗号分割，可以增加抓取速度，例如 visible,selected,enable
@return {bool} true 成功，false 失败

1
function main() {
2
    // 脚本开头执行一次即可
3
    var data = setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": "visible,selected,enable,accessible"})
4
    logd(data);
5
}
6

7
main();

lockNode 锁定节点

经 USB 从手机拉取节点 XML 并锁定到 PC 侧缓存；锁定后界面刷新也不会更新已缓存的节点树，需配合 releaseNode 解锁
支持版本: EC iOS 中控 3.0.0+
与 setFetchNodeParam 配合可缩小抓取范围、加快速度

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

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

10
main();

lockNodeFromXml 从 XML 锁定节点

将外部 XML 字符串注入 PC 侧节点缓存并锁定，可与 auxEvent.agentDumpXml 配合，再继续使用本模块的选择器（label().getNodeInfo() 等）
适配版本 EC iOS 中控 9.39.0+
对象形式：agentEvent.lockNodeFromXml(xml)，见代理事件 - lockNodeFromXml
@param xml XML 字符串（如 auxEvent.agentDumpXml() 的返回值）
@return {bool} true 成功，false 失败

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 失败");
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("设置").getOneNodeInfo(0);
25
    logd("node: {}", nd ? JSON.stringify(nd) : "null");
26
}
27

28
main();

releaseNode 释放节点

释放节点锁定；释放后 getNodeInfo 等会按最新界面重新拉取 XML
支持版本: EC iOS 中控 3.0.0+
与 lockNode、lockNodeFromXml 配对使用

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

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

9
    releaseNode();
10
    logd("节点锁已释放");
11
}
12

13
main();

getNodeInfo 获取节点集合

timeout 超时时间，单位毫秒
支持版本: EC iOS 中控 3.0.0+
@return {array} 节点对象集合

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

6
main();

getOneNodeInfo 获取单节点

timeout 超时时间，单位毫秒
支持版本: EC iOS 中控 3.0.0+
@return {NodeInfo} 节点对象

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

6
main();

以下是选择器函数

id id 属性全匹配

id 属性全匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    // 脚本开头执行一次即可
13
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
14
    // 先释放老的数据
15
    releaseNode();
16
    // 锁定新的节点数据
17
    lockNode();
18
    // 进入查找状态
19
    // 按照 id 查找
20
    let nd = id("设置").getOneNodeInfo(1000)
21
    if (nd) {
22
        console.log("id 查找  节点信息 {}  ", JSON.stringify(nd))
23
        // 如果找到了 就点击
24
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
25
        logd("点他: {}", c)
26
    } else {
27
        console.log("id 未查找  节点信息  ")
28
    }
29
    // 按照 正则表达式匹配
30
    nd = idMatch(".*置.*").getNodeInfo(1000)
31
    if (nd) {
32
        console.log("idMatch 查找  节点信息 {}  ", JSON.stringify(nd))
33
    } else {
34
        console.log("idMatch 未查找  节点信息  ")
35
    }
36
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
47
        if (isServiceOk()) {
48
            return true;
49
        }
50
    }
51
    return isServiceOk();
52
}
53

54
main()

xpath 选择

xpath选择器，xpath技术请看 : https://www.jianshu.com/p/c205334122b3 和 https://www.runoob.com/xpath/xpath-syntax.html
xpath使用请到idea的节点面板查看xpath属性以及测试xpath功能
适配EC 7.7.0+
@param value 例如 //node[@value=‘易点云测’] 代表选取文本等于易点云测的节点

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

8
main();

idMatch id 属性正则匹配

id 属性正则匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 id 查找
19
    let nd = id("设置").getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log("id 查找  节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log("id 未查找  节点信息  ")
27
    }
28
    // 按照 正则表达式匹配
29
    nd = idMatch(".*置.*").getNodeInfo(1000)
30
    if (nd) {
31
        console.log("idMatch 查找  节点信息 {}  ", JSON.stringify(nd))
32
    } else {
33
        console.log("idMatch 未查找  节点信息  ")
34
    }
35
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
46
        if (isServiceOk()) {
47
            return true;
48
        }
49
    }
50
    return isServiceOk();
51
}
52

53
main()

label label属性全匹配

label属性全匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照label查找
19
    let nd = label("设置").getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log("label 查找  节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log("label 未查找  节点信息  ")
27
    }
28
    // 按照 正则表达式匹配
29
    nd = labelMatch(".*置.*").getNodeInfo(1000)
30
    if (nd) {
31
        console.log("labelMatch 查找  节点信息 {}  ", JSON.stringify(nd))
32
    } else {
33
        console.log("labelMatch 未查找  节点信息  ")
34
    }
35
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
46
        if (isServiceOk()) {
47
            return true;
48
        }
49
    }
50
    return isServiceOk();
51
}
52

53
main()

labelMatch label属性正则匹配

label属性正则匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照label查找
19
    let nd = label("设置").getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log("label 查找  节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log("label 未查找  节点信息  ")
27
    }
28
    // 按照 正则表达式匹配
29
    nd = labelMatch(".*置.*").getNodeInfo(1000)
30
    if (nd) {
31
        console.log("labelMatch 查找  节点信息 {}  ", JSON.stringify(nd))
32
    } else {
33
        console.log("labelMatch 未查找  节点信息  ")
34
    }
35
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
46
        if (isServiceOk()) {
47
            return true;
48
        }
49
    }
50
    return isServiceOk();
51
}
52

53
main()

name name属性全匹配

name 属性全匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 name 查找
19
    let nd = name("设置").getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log("name 查找  节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log("name 未查找  节点信息  ")
27
    }
28
    // 按照 name 正则表达式匹配
29
    nd = nameMatch(".*置.*").getNodeInfo(1000)
30
    if (nd) {
31
        console.log("nameMatch 查找  节点信息 {}  ", JSON.stringify(nd))
32
    } else {
33
        console.log("nameMatch 未查找  节点信息  ")
34
    }
35
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
46
        if (isServiceOk()) {
47
            return true;
48
        }
49
    }
50
    return isServiceOk();
51
}
52

53
main()

nameMatch name属性正则匹配

name 属性正则匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 name 查找
19
    let nd = name("设置").getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log("name 查找  节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log("name 未查找  节点信息  ")
27
    }
28
    // 按照 name 正则表达式匹配
29
    nd = nameMatch(".*置.*").getNodeInfo(1000)
30
    if (nd) {
31
        console.log("nameMatch 查找  节点信息 {}  ", JSON.stringify(nd))
32
    } else {
33
        console.log("nameMatch 未查找  节点信息  ")
34
    }
35
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
46
        if (isServiceOk()) {
47
            return true;
48
        }
49
    }
50
    return isServiceOk();
51
}
52

53
main()

type type属性全匹配

type 属性全匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 type 查找
19
    let nd = type("XCUIElementTypeOther").getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log("type 查找  节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log("label 未查找  节点信息  ")
27
    }
28
    // 按照 type 正则表达式匹配
29
    nd = typeMatch(".*XCUIElement.*").getNodeInfo(1000)
30
    if (nd) {
31
        console.log("typeMatch 查找  节点信息 {}  ", JSON.stringify(nd))
32
    } else {
33
        console.log("typeMatch 未查找  节点信息  ")
34
    }
35
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
46
        if (isServiceOk()) {
47
            return true;
48
        }
49
    }
50
    return isServiceOk();
51
}
52

53
main()

typeMatch type属性正则匹配

type 属性正则匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 type 查找
19
    let nd = type("XCUIElementTypeOther").getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log("type 查找  节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log("label 未查找  节点信息  ")
27
    }
28
    // 按照 type 正则表达式匹配
29
    nd = typeMatch(".*XCUIElementTypeOther.*").getNodeInfo(1000)
30
    if (nd) {
31
        console.log("typeMatch 查找  节点信息 {}  ", JSON.stringify(nd))
32
    } else {
33
        console.log("ltypeMatch 未查找  节点信息  ")
34
    }
35
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
46
        if (isServiceOk()) {
47
            return true;
48
        }
49
    }
50
    return isServiceOk();
51
}
52

53
main()

value value属性全匹配

value 属性全匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 value 查找
19
    let nd = value("XCUIElementTypeOther").getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log("value 查找  节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log("value 未查找  节点信息  ")
27
    }
28
    // 按照 type 正则表达式匹配
29
    nd = valueMatch(".*XCUIElementTypeOther.*").getNodeInfo(1000)
30
    if (nd) {
31
        console.log("valueMatch 查找  节点信息 {}  ", JSON.stringify(nd))
32
    } else {
33
        console.log("valueMatch 未查找  节点信息  ")
34
    }
35
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
46
        if (isServiceOk()) {
47
            return true;
48
        }
49
    }
50
    return isServiceOk();
51
}
52

53
main()

valueMatch value属性正则匹配

value 属性正则匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 value 查找
19
    let nd = value("XCUIElementTypeOther").getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log("value 查找  节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log("value 未查找  节点信息  ")
27
    }
28
    // 按照 type 正则表达式匹配
29
    nd = valueMatch(".*XCUIElementTypeOther.*").getNodeInfo(1000)
30
    if (nd) {
31
        console.log("valueMatch 查找  节点信息 {}  ", JSON.stringify(nd))
32
    } else {
33
        console.log("valueMatch 未查找  节点信息  ")
34
    }
35
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
46
        if (isServiceOk()) {
47
            return true;
48
        }
49
    }
50
    return isServiceOk();
51
}
52

53
main()

enable enable属性全匹配

enable 属性全匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 enable , accessible 查找
19
    let nd = enable(true).accessible(true).getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log(" 查找  节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log(" 未查找  节点信息  ")
27
    }
28
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
39
        if (isServiceOk()) {
40
            return true;
41
        }
42
    }
43
    return isServiceOk();
44
}
45

46
main()

accessible accessible属性全匹配

accessible 属性全匹配

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 enabled , accessible 查找
19
    let nd = enabled(true).accessible(true).getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log(" 查找  节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log(" 未查找  节点信息  ")
27
    }
28
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
39
        if (isServiceOk()) {
40
            return true;
41
        }
42
    }
43
    return isServiceOk();
44
}
45

46
main()

visible visible属性全匹配

visible 属性全匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 visible  查找
19
    let nd = visible(true).getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log(" 查找  节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log(" 未查找  节点信息  ")
27
    }
28
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
39
        if (isServiceOk()) {
40
            return true;
41
        }
42
    }
43
    return isServiceOk();
44
}
45

46
main()

index index属性全匹配

index 属性全匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 index  查找
19
    let nd = index(1).getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log(" 查找 节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log(" 未查找  节点信息  ")
27
    }
28
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
39
        if (isServiceOk()) {
40
            return true;
41
        }
42
    }
43
    return isServiceOk();
44
}
45

46
main()

depth depth 属性全匹配

depth 属性全匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 depth  查找
19
    let nd = depth(1).getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log(" 查找 节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log(" 未查找  节点信息  ")
27
    }
28
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
39
        if (isServiceOk()) {
40
            return true;
41
        }
42
    }
43
    return isServiceOk();
44
}
45

46
main()

selected selected 属性全匹配

selected 属性全匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 selected  查找
19
    let nd = selected(true).getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log(" 查找 节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log(" 未查找  节点信息  ")
27
    }
28
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
39
        if (isServiceOk()) {
40
            return true;
41
        }
42
    }
43
    return isServiceOk();
44
}
45

46
main()

childcount childcount属性全匹配

childcount 属性全匹配

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 childCount  查找
19
    let nd = childCount(2).getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log(" 查找  节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log(" 未查找  节点信息  ")
27
    }
28
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
39
        if (isServiceOk()) {
40
            return true;
41
        }
42
    }
43
    return isServiceOk();
44
}
45

46
main()

bounds bounds属性范围匹配

bounds 属性范围匹配
支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 bounds  查找
19
    let nd = bounds(100, 100, 300, 300).getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log(" 查找  节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log(" 未查找  节点信息  ")
27
    }
28
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
39
        if (isServiceOk()) {
40
            return true;
41
        }
42
    }
43
    return isServiceOk();
44
}
45

46
main()

点击节点

clickCenter 点击节点中心点

点击节点中心点
支持版本: EC iOS 中控 3.0.0+
@return {bool} true 成功，false 失败

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

14
}
15

16
main()

clickRandom 随机点击节点

随机点击节点的坐标
支持版本: EC iOS 中控 3.0.0+
@return {bool} true 成功，false 失败

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

14
}
15

16
main()

多属性级联查询

支持版本: EC iOS 中控 3.0.0+

1
function main() {
2
    //开始再这里编写代码了！！
3
    logd("检查自动化环境...")
4
    //如果自动化服务正常
5
    if (!autoServiceStart(3)) {
6
        logd("自动化服务启动失败，无法执行脚本")
7
        exit();
8
        return;
9
    }
10
    logd("开始执行脚本...")
11
    // 设置读取节点的参数, 具体请看设置节点参数的含义
12
    setFetchNodeParam({"labelFilter": "2", "maxDepth": "20", "visibleFilter": "2", "excludedAttributes": ""})
13
    // 先释放老的数据
14
    releaseNode();
15
    // 锁定新的节点数据
16
    lockNode();
17
    // 进入查找状态
18
    // 按照 级联模式  查找
19
    let nd = labelMatch(".*1.*").enabled(true).accessible(true).bounds(100, 100, 300, 300).getOneNodeInfo(1000)
20
    if (nd) {
21
        console.log(" 查找  节点信息 {}  ", JSON.stringify(nd))
22
        // 如果找到了 就点击
23
        let c = clickPoint(nd.bounds.centerX(), nd.bounds.centerY());
24
        logd("点他: {}", c)
25
    } else {
26
        console.log(" 未查找  节点信息  ")
27
    }
28
    // 先释放老的数据
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("第" + (i + 1) + "次启动服务结果: " + started);
39
        if (isServiceOk()) {
40
            return true;
41
        }
42
    }
43
    return isServiceOk();
44
}
45

46
main()

以下是节点的级联操作

parent 查询节点的父级

查询节点的父级
支持版本: EC iOS 中控 3.0.0+
@return {NodeInfo} 节点对象

1
function main() {
2
    // 进入查找状态
3
    let nd = labelMatch(".*1.*").getOneNodeInfo(1000)
4
    if (nd) {
5
        console.log(" 查找  节点信息 {}  ", JSON.stringify(nd))
6
        let parent = nd.parent()
7
        console.log(" 查找 parent {}  ", JSON.stringify(parent))
8
    } else {
9
        console.log(" 未查找  节点信息  ")
10
    }
11
// 先释放老的数据
12
    releaseNode();
13
}
14

15

16
main()

child 取得单个子节点

取得单个子节点
支持版本: EC iOS 中控 3.0.0+
@param index – 子节点索引
@return {NodeInfo} NodeInfo 对象或者null

1
function main() {
2
    // 进入查找状态
3
    let nd = labelMatch(".*1.*").getOneNodeInfo(1000)
4
    if (nd) {
5
        console.log(" 查找  节点信息 {}  ", JSON.stringify(nd))
6
        let child1 = nd.child(0)
7
        console.log(" 查找 child {}  ", JSON.stringify(child1))
8
    } else {
9
        console.log(" 未查找  节点信息  ")
10
    }
11
// 先释放老的数据
12
    releaseNode();
13
}
14

15

16
main()

allChildren 取得所有子节点

取得所有子节点
支持版本: EC iOS 中控 3.0.0+
@return {array} NodeInfo 节点集合

1
function main() {
2
    // 进入查找状态
3
    let nd = labelMatch(".*1.*").getOneNodeInfo(1000)
4
    if (nd) {
5
        console.log(" 查找  节点信息 {}  ", JSON.stringify(nd))
6
        let allChildren = nd.allChildren()
7
        console.log(" 查找 allChildren {}  ", JSON.stringify(allChildren))
8
    } else {
9
        console.log(" 未查找  节点信息  ")
10
    }
11
// 先释放老的数据
12
    releaseNode();
13
}
14

15

16
main()

siblings 取得所有兄弟节点

当前节点的所有兄弟节点
支持版本: EC iOS 中控 3.0.0+
@return {array} NodeInfo 节点集合

1
function main() {
2
    // 进入查找状态
3
    let nd = labelMatch(".*1.*").getOneNodeInfo(1000)
4
    if (nd) {
5
        console.log(" 查找  节点信息 {}  ", JSON.stringify(nd))
6
        let siblings = nd.siblings()
7
        console.log(" 查找 siblings {}  ", JSON.stringify(siblings))
8
    } else {
9
        console.log(" 未查找  节点信息  ")
10
    }
11
// 先释放老的数据
12
    releaseNode();
13
}
14

15
main()

previousSiblings 取得前面的兄弟节点

在当前节点前面的兄弟节点
支持版本: EC iOS 中控 3.0.0+
@return {array} NodeInfo 节点集合

1
function main() {
2
    // 进入查找状态
3
    let nd = labelMatch(".*1.*").getOneNodeInfo(1000)
4
    if (nd) {
5
        console.log(" 查找  节点信息 {}  ", JSON.stringify(nd))
6
        let previousSiblings = nd.previousSiblings()
7
        console.log(" 查找 previousSiblings {}  ", JSON.stringify(previousSiblings))
8
    } else {
9
        console.log(" 未查找  节点信息  ")
10
    }
11
// 先释放老的数据
12
    releaseNode();
13
}
14

15
main()

nextSiblings 取得后面的兄弟节点

在当前节点后面的兄弟节点
支持版本: EC iOS 中控 3.0.0+
@return {array} NodeInfo 节点集合

1
function main() {
2
    // 进入查找状态
3
    let nd = labelMatch(".*1.*").getOneNodeInfo(1000)
4
    if (nd) {
5
        console.log(" 查找  节点信息 {}  ", JSON.stringify(nd))
6
        let nextSiblings = nd.nextSiblings()
7
        console.log(" 查找 nextSiblings {}  ", JSON.stringify(nextSiblings))
8
    } else {
9
        console.log(" 未查找  节点信息  ")
10
    }
11
// 先释放老的数据
12
    releaseNode();
13
}
14

15
main()