选择器&节点

说明

这个章节主要讲解选择器类使用和节点信息类

选择器对象

选择器对象是支持级联选择，可以在无法直接选择到元素的时候，先通过选择父级后再选择子级
选择器部分支撑正则匹配，请参考java的正则语法，教程

xpath 选择

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

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

8
main();

text属性选择

全文本匹配

1
function main() {
2
    //获取选择器对象
3
    var selector = text("设置");
4
    click(selector);
5
}
6

7
main();

正则匹配

1
function main() {
2
    //获取选择器对象
3
    var selector = textMatch(".*设置.*");
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

id 属性选择

全量匹配

1
function main() {
2
    //获取选择器对象
3
    var selector = id("com.xx:id/a1");
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

正则匹配

1
function main() {
2
    //获取选择器对象
3
    var selector = idMatch(".*id8.*");
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

clz 属性选择

全量匹配

1
function main() {
2
    //获取选择器对象
3
    var selector = clz("android.widget.TextView");
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

正则匹配

1
function main() {
2
    //获取选择器对象
3
    var selector = clzMatch(".*TextView.*");
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

pkg 属性选择

全量匹配

1
function main() {
2
    //获取选择器对象
3
    var selector = pkg("com.xx");
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

正则匹配

1
function main() {
2
    //获取选择器对象
3
    var selector = pkgMatch(".*tencent.*");
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

desc 文本属性选择

全量匹配

1
function main() {
2
    //获取选择器对象
3
    var selector = desc("我是描述");
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

正则匹配

1
function main() {
2
    //获取选择器对象
3
    var selector = descMatch(".*描述.*");
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main()

深度和绘制顺序匹配

drawingOrder

1
function main() {
2
    //获取选择器对象
3
    var selector = drawingOrder(1);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

depth

1
function main() {
2
    //获取选择器对象
3
    var selector = depth(1);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

其他匹配规则

visible 可视化属性匹配

按照属性 visible 进行匹配
@param value 字符串
@return {S} 节点选择器

1
function main() {
2
    var node = visible(true).getOneNodeInfo(1000);
3
    logd("node " + node);
4
}
5

6
main();

bounds 范围匹配

按照属性 bounds 进行范围
@param left 范围左边数值
@param top 范围上边数值
@param right 范围右边数值
@param bottom 范围底边数值
@return {S} 节点选择器

1
function main() {
2
    //获取选择器对象 0 - 800以内范围内的控件
3
    var selector = bounds(0, 0, 800, 800);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

checkable

1
function main() {
2
    //获取选择器对象
3
    var selector = checkable(true);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

checked

1
function main() {
2
    //获取选择器对象
3
    var selector = checked(true);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

clickable

1
function main() {
2
    //获取选择器对象
3
    var selector = clickable(true);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

longClickable

1
function main() {
2
    //获取选择器对象
3
    var selector = longClickable(true);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

scrollable

1
function main() {
2
    //获取选择器对象
3
    var selector = scrollable(true);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

focusable

1
function main() {
2
    //获取选择器对象
3
    var selector = focusable(true);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

enabled

1
function main() {
2
    //获取选择器对象
3
    var selector = enabled(true);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

focused

1
function main() {
2
    //获取选择器对象
3
    var selector = focused(true);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

selected

1
function main() {
2
    //获取选择器对象
3
    var selector = selected(true);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

index

1
function main() {
2
    //获取选择器对象
3
    var selector = index(1);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

childCount

1
function main() {
2
    //获取选择器对象
3
    var selector = childCount(1);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

row

1
function main() {
2
    //获取选择器对象
3
    var selector = row(1);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

column

1
function main() {
2
    //获取选择器对象
3
    var selector = column(1);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

rowSpan

1
function main() {
2
    //获取选择器对象
3
    var selector = rowSpan(1);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

columnSpan

1
function main() {
2
    //获取选择器对象
3
    var selector = columnSpan(1);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

rowCount

1
function main() {
2
    //获取选择器对象
3
    var selector = rowCount(1);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

columnCount

1
function main() {
2
    //获取选择器对象
3
    var selector = columnCount(1);
4
    var result = click(selector);
5
    if (result) {
6
        toast("点击成功");
7
    } else {
8
        toast("点击失败");
9
    }
10
}
11

12
main();

级联匹配

1
function main() {
2
    //获取选择器对象
3
    //选择 父级为android.widget.ScrollView下的子节点clz=android.widget.CheckBox所有节点
4
    var selector = clz("android.widget.ScrollView")
5
        .child()
6
        .clz("android.widget.CheckBox");
7
    var result = click(selector);
8
    if (result) {
9
        toast("点击成功");
10
    } else {
11
        toast("点击失败");
12
    }
13
}
14

15
main();

多属性匹配

1
function main() {
2
    //获取选择器对象，
3
    //选择包含"选择器"并且checked=true并且类名=android.widget.CheckBox的元素
4
    var selector = textMatch(".*选择器.*")
5
        .checked(true)
6
        .clz("android.widget.CheckBox");
7
    var result = click(selector);
8
    if (result) {
9
        toast("点击成功");
10
    } else {
11
        toast("点击失败");
12
    }
13
}
14

15
main();

节点信息类

说明

节点对象NodeInfo，可以通过获取getNodeInfo方法获取到节点信息的数组,节点包含的信息如下

id: 字符串，资源的ID
clz: 字符串，视图类名，例如 android.widget.TextView
pkg: 字符串，包名，例如com.xx
desc: 字符串，内容描述
text: 字符串，文本
checkable: 布尔型，是否可选中
checked: 布尔型，是否选中
clickable: 布尔型，是否可点击
enabled: 布尔型，是否启用
focusable: 布尔型，是否可获取焦点
focused: 布尔型，是否聚焦
longClickable: 布尔型，是否可长点击
scrollable: 布尔型，是否滚动
selected: 布尔型，是否被选择
childCount: 整型，子节点的个数
index: 整型节点的索引
depth: 整型节点的层级深度
drawingOrder: 整型节点的绘制顺序
bounds: Rect型，空间对象
top: 整型，顶部位置
bottom: 整型，底部位置
left: 整型，左边位置
right: 整型，右边位置
visibleBounds: Rect型，可视空间对象
top: 整型，顶部位置
bottom: 整型，底部位置
left: 整型，左边位置
right: 整型，右边位置

选择器获取一个节点 getOneNodeInfo

通过选择器获取第一个节点信息
@param timeout 等待时间，单位是毫秒, 如果是0，代表不等待
@return NodeInfo 对象或者null

1
function main() {
2
    //获取选择器对象
3
    //选择 节点 clz=android.widget.CheckBox所有节点，
4
    var node = clz("android.widget.CheckBox").getOneNodeInfo(10000);
5

6
    if (node) {
7
        var x = node.click();
8
        logd(x);
9
    } else {
10
        toast("无节点");
11
    }
12
}
13

14
main();

选择器获取多个节点 getNodeInfo

获取节点信息
@param timeout 等待时间，单位是毫秒, 如果是0，代表不等待
@return NodeInfo 节点信息集合

1
function main() {
2
    //获取选择器对象
3
    //选择 节点 clz=android.widget.CheckBox所有节点，
4
    var node = clz("android.widget.CheckBox").getNodeInfo(10000);
5
    //这玩意是个数组
6
    for (let i = 0; i < node.length; i++) {
7
        logd(JSON.stringify(node[i]))
8
    }
9
}
10

11
main();

级联获取一个子节点操作 getOneNodeInfo

通过选择器获取第一个节点信息
@param timeout 等待时间，单位是毫秒, 如果是0，代表不等待
@return NodeInfo 对象或者null

1
function main() {
2
    //获取选择器对象
3
    //选择 节点 clz=android.widget.ViewGroup 所有节点，
4
    var node = clz("android.widget.ViewGroup").getOneNodeInfo(10000);
5
    if (node) {
6
        //获取子节点
7
        node = node.getOneNodeInfo(text("广告"), 10000);
8
        if (!node) {
9
            toast("无子节点");
10
            return;
11
        }
12
        var x = node.click();
13
        logd(x);
14
    } else {
15
        toast("无节点");
16
    }
17
}
18

19
main();

级联获取多个子节点操作 getNodeInfo

获取节点信息
@param timeout 等待时间，单位是毫秒, 如果是0，代表不等待
@return NodeInfo 节点信息集合

1
function main() {
2
    //获取选择器对象
3
    //选择 节点 clz=android.widget.ViewGroup 所有节点，
4
    var node = clz("android.widget.ViewGroup").getNodeInfo(10000);
5
    if (node) {
6
        //获取子节点
7
        node = node.getNodeInfo(text("广告").clz("android.widget.TextView"), 10000);
8
        if (!node) {
9
            toast("无子节点");
10
            return;
11
        }
12
        var x = node.click();
13
        logd(x);
14
    } else {
15
        toast("无节点");
16
    }
17
}
18

19
main();

获取父节点 parent

该节点的父级节点
@return NodeInfo 对象或者null

1
function main() {
2
    //获取选择器对象
3
    //选择 节点 clz=android.widget.CheckBox所有节点
4
    var node = clz("android.widget.CheckBox").getOneNodeInfo(10000);
5
    if (node) {
6
        var x = node.parent();
7
        logd(x);
8
    } else {
9
        toast("无节点");
10
    }
11
}
12

13
main();

获取子节点 child

取得单个子节点
@param index 子节点索引
@return NodeInfo 对象或者null

1
function main() {
2
    //选择 节点 clz=android.widget.ViewGroup 所有节点
3
    var node = clz("android.widget.ViewGroup").getOneNodeInfo(10000);
4
    if (node) {
5
        var x = node.child(0);
6
        logd(x);
7
    } else {
8
        toast("无节点");
9
    }
10
}
11

12
main();

获取所有子节点 allChildren

获取所有子节点
@return NodeInfo 节点集合

1
function main() {
2
    //选择 节点 clz=android.widget.ViewGroup 所有节点
3
    var node = clz("android.widget.ViewGroup").getOneNodeInfo(10000);
4
    if (node) {
5
        var x = node.allChildren();
6
        //这玩意是个数组
7
        for (let i = 0; i < x.length; i++) {
8
            logd(x[i])
9
        }
10
    } else {
11
        toast("无节点");
12
    }
13
}
14

15
main();

所有兄弟节点 siblings

当前节点的所有兄弟节点
@return NodeInfo 节点集合

1
function main() {
2
    //选择 节点 clz=android.widget.ViewGroup 所有节点
3
    var node = clz("android.widget.ViewGroup").getOneNodeInfo(10000);
4
    if (node) {
5
        var x = node.siblings();
6
        //这玩意是个数组
7
        for (let i = 0; i < x.length; i++) {
8
            logd(x[i])
9
        }
10
    } else {
11
        toast("无节点");
12
    }
13
}
14

15
main();

前面的兄弟节点 previousSiblings

在当前节点前面的兄弟节点
@return NodeInfo 节点集合

1
function main() {
2
    //选择 节点 clz=android.widget.ViewGroup 所有节点
3
    var node = clz("android.widget.ViewGroup").getOneNodeInfo(10000);
4
    if (node != null) {
5
        let x = node.previousSiblings();
6
        //这玩意是个数组
7
        for (let i = 0; i < x.length; i++) {
8
            logd(x[i])
9
        }
10
    } else {
11
        toast("无节点");
12
    }
13
}
14

15
main();

后面的兄弟节点 nextSiblings

在当前节点后面的兄弟节点
@return NodeInfo 节点集合

1
function main() {
2
    //选择 节点 clz=android.widget.ViewGroup 所有节点
3
    var node = clz("android.widget.ViewGroup").getOneNodeInfo(10000);
4
    if (node) {
5
        let x = node.nextSiblings();
6
        //这玩意是个数组
7
        for (let i = 0; i < x.length; i++) {
8
            logd(x[i])
9
        }
10
    } else {
11
        toast("无节点");
12
    }
13
}
14

15
main();

节点区域随机点击 click

执行条件：无障碍7.0以上或者手势执行为代理服务
点击节点
@return bool, true 成功 ,false 失败

1
function main() {
2
    //获取选择器对象
3
    //选择 节点 clz=android.widget.CheckBox所有节点
4
    var node = clz("android.widget.CheckBox").getOneNodeInfo(10000);
5
    if (node) {
6
        node.click()
7
    } else {
8
        toast("无节点");
9
    }
10
}
11

12
main();

无指针点击 clickEx

执行条件：无障碍5.0以上或者手势执行为代理服务
无指针方式点击选择器，节点必须是可点击的才行
@param selectors 选择器对象
@return {boolean|布尔型}

1
function main() {
2
    var node = text("我是文本").getOneNodeInfo(10000);
3
    var result = node.clickEx();
4
    if (result) {
5
        toast("点击成功");
6
    } else {
7
        toast("点击失败");
8
    }
9
}
10

11
main();

无指针长点击 longClickEx

执行条件：无障碍5.0以上或者手势执行为代理服务
无指针方式长点击选择器，节点必须是可点击的才行
@param selectors 选择器对象
@return {boolean|布尔型}

1
function main() {
2
    var node = text("我是文本").getOneNodeInfo(10000);
3
    var result = node.longClickEx();
4
    if (result) {
5
        toast("点击成功");
6
    } else {
7
        toast("点击失败");
8
    }
9
}
10

11
main();

节点点击中心点 clickCenter

执行条件：无障碍7.0以上或者手势执行为代理服务
节点点击中心点
@return bool, true 成功 ,false 失败

1
function main() {
2
    //获取选择器对象
3
    //选择 节点 clz=android.widget.CheckBox所有节点
4
    var node = clz("android.widget.CheckBox").getOneNodeInfo(10000);
5
    if (node) {
6
        node.clickCenter();
7
    } else {
8
        toast("无节点");
9
    }
10
}
11

12
main();

节点长点击 longClick

执行条件：无障碍7.0以上或者手势执行为代理服务
长点击节点
@return bool, true 成功 ,false 失败

1
function main() {
2
    //获取选择器对象
3
    //选择 节点 clz=android.widget.CheckBox所有节点
4
    var node = clz("android.widget.CheckBox").getOneNodeInfo(10000);
5
    if (node) {
6
        node.longClick()
7
    } else {
8
        toast("无节点");
9
    }
10
}
11

12
main();

节点输入 inputText

执行条件：无障碍5.0以上或者手势执行为代理服务
对某个节点输入数据
@param content 要输入的内容
@return bool, true 成功 ,false 失败

1
function main() {
2
    //获取选择器对象
3
    //选择 节点 clz=android.widget.EditText 所有节点
4
    var node = clz("android.widget.EditText").getOneNodeInfo(10000);
5
    if (node) {
6
        node.inputText("内容")
7
    } else {
8
        toast("无节点");
9
    }
10
}
11

12
main();

节点输入法输入 imeInputText

执行条件：无障碍5.0以上或者手势执行为代理服务
使用输入法对某个节点输入数据，前提是已经设置本程序的输入法为默认输入法
@param content 要输入的内容
@return bool, true 成功 ,false 失败

1
function main() {
2
    //获取选择器对象
3
    //选择 节点 clz=android.widget.EditText 所有节点
4
    var node = clz("android.widget.EditText").getOneNodeInfo(10000);
5
    if (node) {
6
        node.imeInputText("内容")
7
    } else {
8
        toast("无节点");
9
    }
10
}
11

12
main();

imeInputKeyCode

使用输入法输入内容，前提是已经设置本程序的输入法为默认输入法
适合没有节点的情况，例如游戏等
@param selectors 选择器，可以为空，如果为空，前提是输入框是聚焦的状态
@param content 具体请看 KeyEvent.KEYCODE_*的值，例如66 = enter 67=del,84=SEARCH
@return {boolean|布尔型}

1
function main() {
2
    var result = clz("android.widget.EditText").getOneNodeInfo(10000);
3
    if (result) {
4
        result.imeInputKeyCode(66);
5
        toast("是");
6
    } else {
7
        toast("否");
8
    }
9
}
10

11
main();

节点数据清除 clearText

执行条件：无障碍5.0以上或者手势执行为代理服务
清除节点文本数据

1
function main() {
2
    //获取选择器对象
3
    //选择 节点 clz=android.widget.EditText 所有节点
4
    var node = clz("android.widget.EditText").getOneNodeInfo(10000);
5
    if (node) {
6
        var r = node.clearText();
7
        logd("r -=" + r);
8
    } else {
9
        toast("无节点");
10
    }
11
}
12

13
main();

节点刷新 refresh

该方法会刷新节点缓存

1
function main() {
2
    //获取选择器对象
3
    //选择 节点 clz=android.widget.EditText 所有节点
4
    var node = clz("android.widget.EditText").getOneNodeInfo(10000);
5
    if (node) {
6
        node.refresh();
7
    } else {
8
        toast("无节点");
9
    }
10
}
11

12
main();

节点有效判断 isValid

节点信息是否有效 @return bool|布尔型 true代表有

1
function main() {
2
    //获取选择器对象
3
    //选择 节点 clz=android.widget.EditText 所有节点
4
    var node = clz("android.widget.EditText").getOneNodeInfo(10000);
5
    if (node) {
6
        var x = node.isValid();
7
        toast("节点有效性:" + x);
8
    } else {
9
        toast("无节点");
10
    }
11
}
12

13
main();

向前滚动 scrollForward

执行条件：无障碍5.0以上或者手势执行为代理服务
向前滚动
@param selectors 选择器对象
@return {boolean|布尔型}

1
function main() {
2
    var node = scrollable(true).getOneNodeInfo(10000);
3
    var result = node.scrollForward();
4
    if (result) {
5
        toast("滚动成功");
6
    } else {
7
        toast("滚动失败");
8
    }
9
}
10

11
main();

向后滚动 scrollBackward

执行条件：无障碍5.0以上或者手势执行为代理服务
向后滚动
@param selectors 选择器对象
@return {boolean|布尔型}

1
function main() {
2
    var node = scrollable(true).getOneNodeInfo(10000);
3
    var result = node.scrollBackward();
4
    if (result) {
5
        toast("滚动成功");
6
    } else {
7
        toast("滚动失败");
8
    }
9
}
10

11
main();