跳到主要内容

选择器&节点

说明

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

选择器对象

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

text属性选择

全文本匹配

function main() {
//获取选择器对象
var selector = text("设置");
click(selector);
}

main();

正则匹配


function main() {
//获取选择器对象
var selector = textMatch(".*设置.*");
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

id 属性选择

全量匹配


function main() {
//获取选择器对象
var selector = id("com.xx:id/a1");
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

正则匹配


function main() {
//获取选择器对象
var selector = idMatch(".*id8.*");
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

clz 属性选择

全量匹配


function main() {
//获取选择器对象
var selector = clz("android.widget.TextView");
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

正则匹配


function main() {
//获取选择器对象
var selector = clzMatch(".*TextView.*");
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

pkg 属性选择

全量匹配


function main() {
//获取选择器对象
var selector = pkg("com.xx");
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

正则匹配


function main() {
//获取选择器对象
var selector = pkgMatch(".*tencent.*");
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

desc 文本属性选择

全量匹配


function main() {
//获取选择器对象
var selector = desc("我是描述");
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

正则匹配


function main() {
//获取选择器对象
var selector = descMatch(".*描述.*");
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main()

深度和绘制顺序匹配

drawingOrder


function main() {
//获取选择器对象
var selector = drawingOrder(1);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

depth


function main() {
//获取选择器对象
var selector = depth(1);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

其他匹配规则

visible 可视化属性匹配

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

function main() {
var node = visible(true).getOneNodeInfo(1000);
logd("node " + node);
}

main();

bounds 范围匹配

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

function main() {
//获取选择器对象 0 - 800以内范围内的控件
var selector = bounds(0, 0, 800, 800);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

checkable


function main() {
//获取选择器对象
var selector = checkable(true);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

checked


function main() {
//获取选择器对象
var selector = checked(true);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

clickable


function main() {
//获取选择器对象
var selector = clickable(true);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

longClickable


function main() {
//获取选择器对象
var selector = longClickable(true);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

scrollable


function main() {
//获取选择器对象
var selector = scrollable(true);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

focusable


function main() {
//获取选择器对象
var selector = focusable(true);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

enabled


function main() {
//获取选择器对象
var selector = enabled(true);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

focused


function main() {
//获取选择器对象
var selector = focused(true);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

selected


function main() {
//获取选择器对象
var selector = selected(true);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

index


function main() {
//获取选择器对象
var selector = index(1);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

childCount


function main() {
//获取选择器对象
var selector = childCount(1);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

row


function main() {
//获取选择器对象
var selector = row(1);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

column


function main() {
//获取选择器对象
var selector = column(1);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

rowSpan


function main() {
//获取选择器对象
var selector = rowSpan(1);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

columnSpan


function main() {
//获取选择器对象
var selector = columnSpan(1);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

rowCount


function main() {
//获取选择器对象
var selector = rowCount(1);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

columnCount


function main() {
//获取选择器对象
var selector = columnCount(1);
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

级联匹配


function main() {
//获取选择器对象
//选择 父级为android.widget.ScrollView下的子节点clz=android.widget.CheckBox所有节点
var selector = clz("android.widget.ScrollView")
.child()
.clz("android.widget.CheckBox");
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

多属性匹配


function main() {
//获取选择器对象,
//选择包含"选择器"并且checked=true并且类名=android.widget.CheckBox的元素
var selector = textMatch(".*选择器.*")
.checked(true)
.clz("android.widget.CheckBox");
var result = click(selector);
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

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
function main() {
//获取选择器对象
//选择 节点 clz=android.widget.CheckBox所有节点,
var node = clz("android.widget.CheckBox").getOneNodeInfo(10000);

if (node) {
var x = node.click();
logd(x);
} else {
toast("无节点");
}
}

main();

选择器获取多个节点 getNodeInfo

  • 获取节点信息
  • @param timeout 等待时间,单位是毫秒, 如果是0,代表不等待
  • @return NodeInfo 节点信息集合
function main() {
//获取选择器对象
//选择 节点 clz=android.widget.CheckBox所有节点,
var node = clz("android.widget.CheckBox").getNodeInfo(10000);
//这玩意是个数组
for (let i = 0; i < node.length; i++) {
logd(JSON.stringify(node[i]))
}
}

main();

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

  • 通过选择器 获取第一个节点信息
  • @param timeout 等待时间,单位是毫秒, 如果是0,代表不等待
  • @return NodeInfo 对象 或者null
function main() {
//获取选择器对象
//选择 节点 clz=android.widget.ViewGroup 所有节点,
var node = clz("android.widget.ViewGroup").getOneNodeInfo(10000);
if (node) {
//获取子节点
node = node.getOneNodeInfo(text("广告"), 10000);
if (!node) {
toast("无子节点");
return;
}
var x = node.click();
logd(x);
} else {
toast("无节点");
}
}

main();

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

  • 获取节点信息
  • @param timeout 等待时间,单位是毫秒, 如果是0,代表不等待
  • @return NodeInfo 节点信息集合
function main() {
//获取选择器对象
//选择 节点 clz=android.widget.ViewGroup 所有节点,
var node = clz("android.widget.ViewGroup").getNodeInfo(10000);
if (node) {
//获取子节点
node = node.getNodeInfo(text("广告").clz("android.widget.TextView"), 10000);
if (!node) {
toast("无子节点");
return;
}
var x = node.click();
logd(x);
} else {
toast("无节点");
}
}

main();

获取父节点 parent

  • 该节点的父级节点
  • @return NodeInfo 对象 或者null
function main() {
//获取选择器对象
//选择 节点 clz=android.widget.CheckBox所有节点
var node = clz("android.widget.CheckBox").getOneNodeInfo(10000);
if (node) {
var x = node.parent();
logd(x);
} else {
toast("无节点");
}
}

main();

获取子节点 child

  • 取得单个子节点
  • @param index 子节点索引
  • @return NodeInfo 对象 或者null
function main() {
//选择 节点 clz=android.widget.ViewGroup 所有节点
var node = clz("android.widget.ViewGroup").getOneNodeInfo(10000);
if (node) {
var x = node.child(0);
logd(x);
} else {
toast("无节点");
}
}

main();

获取所有子节点 allChildren

  • 获取所有子节点
  • @return NodeInfo 节点集合
function main() {
//选择 节点 clz=android.widget.ViewGroup 所有节点
var node = clz("android.widget.ViewGroup").getOneNodeInfo(10000);
if (node) {
var x = node.allChildren();
//这玩意是个数组
for (let i = 0; i < x.length; i++) {
logd(x[i])
}
} else {
toast("无节点");
}
}

main();

所有兄弟节点 siblings

  • 当前节点的所有兄弟节点
  • @return NodeInfo 节点集合
function main() {
//选择 节点 clz=android.widget.ViewGroup 所有节点
var node = clz("android.widget.ViewGroup").getOneNodeInfo(10000);
if (node) {
var x = node.siblings();
//这玩意是个数组
for (let i = 0; i < x.length; i++) {
logd(x[i])
}
} else {
toast("无节点");
}
}

main();

前面的兄弟节点 previousSiblings

  • 在当前节点前面的兄弟节点
  • @return NodeInfo 节点集合
function main() {
//选择 节点 clz=android.widget.ViewGroup 所有节点
var node = clz("android.widget.ViewGroup").getOneNodeInfo(10000);
if (node != null) {
let x = node.previousSiblings();
//这玩意是个数组
for (let i = 0; i < x.length; i++) {
logd(x[i])
}
} else {
toast("无节点");
}
}

main();

后面的兄弟节点 nextSiblings

  • 在当前节点后面的兄弟节点
  • @return NodeInfo 节点集合
function main() {
//选择 节点 clz=android.widget.ViewGroup 所有节点
var node = clz("android.widget.ViewGroup").getOneNodeInfo(10000);
if (node) {
let x = node.nextSiblings();
//这玩意是个数组
for (let i = 0; i < x.length; i++) {
logd(x[i])
}
} else {
toast("无节点");
}
}

main();

节点区域随机点击 click

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

function main() {
//获取选择器对象
//选择 节点 clz=android.widget.CheckBox所有节点
var node = clz("android.widget.CheckBox").getOneNodeInfo(10000);
if (node) {
node.click()
} else {
toast("无节点");
}
}

main();

无指针点击 clickEx

  • 执行条件:无障碍5.0以上或者手势执行为代理服务
  • 无指针方式点击选择器,节点必须是可点击的才行
  • @param selectors 选择器对象
  • @return {boolean|布尔型}
function main() {
var node = text("我是文本").getOneNodeInfo(10000);
var result = node.clickEx();
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

无指针长点击 longClickEx

  • 执行条件:无障碍5.0以上或者手势执行为代理服务
  • 无指针方式长点击选择器,节点必须是可点击的才行
  • @param selectors 选择器对象
  • @return {boolean|布尔型}
function main() {
var node = text("我是文本").getOneNodeInfo(10000);
var result = node.longClickEx();
if (result) {
toast("点击成功");
} else {
toast("点击失败");
}
}

main();

节点点击中心点 clickCenter

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

function main() {
//获取选择器对象
//选择 节点 clz=android.widget.CheckBox所有节点
var node = clz("android.widget.CheckBox").getOneNodeInfo(10000);
if (node) {
node.clickCenter();
} else {
toast("无节点");
}
}

main();

节点长点击 longClick

  • 执行条件:无障碍7.0以上或者手势执行为代理服务
  • 长点击节点
  • @return bool, true 成功 ,false 失败
function main() {
//获取选择器对象
//选择 节点 clz=android.widget.CheckBox所有节点
var node = clz("android.widget.CheckBox").getOneNodeInfo(10000);
if (node) {
node.longClick()
} else {
toast("无节点");
}
}

main();

节点输入 inputText

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

function main() {
//获取选择器对象
//选择 节点 clz=android.widget.EditText 所有节点
var node = clz("android.widget.EditText").getOneNodeInfo(10000);
if (node) {
node.inputText("内容")
} else {
toast("无节点");
}
}

main();

节点输入法输入 imeInputText

  • 执行条件:无障碍5.0以上或者手势执行为代理服务
  • 使用输入法对某个节点输入数据,前提是已经设置本程序的输入法为默认输入法
  • @param content 要输入的内容
  • @return bool, true 成功 ,false 失败
function main() {
//获取选择器对象
//选择 节点 clz=android.widget.EditText 所有节点
var node = clz("android.widget.EditText").getOneNodeInfo(10000);
if (node) {
node.imeInputText("内容")
} else {
toast("无节点");
}
}

main();

imeInputKeyCode

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

function main() {
var result = clz("android.widget.EditText").getOneNodeInfo(10000);
if (result) {
result.imeInputKeyCode(66);
toast("是");
} else {
toast("否");
}
}

main();

节点数据清除 clearText

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

function main() {
//获取选择器对象
//选择 节点 clz=android.widget.EditText 所有节点
var node = clz("android.widget.EditText").getOneNodeInfo(10000);
if (node) {
var r = node.clearText();
logd("r -=" + r);
} else {
toast("无节点");
}
}

main();

节点刷新 refresh

  • 该方法会刷新节点缓存
function main() {
//获取选择器对象
//选择 节点 clz=android.widget.EditText 所有节点
var node = clz("android.widget.EditText").getOneNodeInfo(10000);
if (node) {
node.refresh();
} else {
toast("无节点");
}
}

main();

节点有效判断 isValid

  • 节点信息是否有效 @return bool|布尔型 true代表有
function main() {
//获取选择器对象
//选择 节点 clz=android.widget.EditText 所有节点
var node = clz("android.widget.EditText").getOneNodeInfo(10000);
if (node) {
var x = node.isValid();
toast("节点有效性:" + x);
} else {
toast("无节点");
}
}

main();

向前滚动 scrollForward

  • 执行条件:无障碍5.0以上或者手势执行为代理服务
  • 向前滚动
  • @param selectors 选择器对象
  • @return {boolean|布尔型}
function main() {
var node = scrollable(true).getOneNodeInfo(10000);
var result = node.scrollForward();
if (result) {
toast("滚动成功");
} else {
toast("滚动失败");
}
}

main();

向后滚动 scrollBackward

  • 执行条件:无障碍5.0以上或者手势执行为代理服务
  • 向后滚动
  • @param selectors 选择器对象
  • @return {boolean|布尔型}
function main() {
var node = scrollable(true).getOneNodeInfo(10000);
var result = node.scrollBackward();
if (result) {
toast("滚动成功");
} else {
toast("滚动失败");
}
}

main();