微信小程序自动化测试框架 Minium—— 元素定位

在做小程序UI自动化时,大家遇到最多的,也是最基础的问题是,如何识别或定位需要操作的元素。

Minium关于元素操作的文档可以参考 元素定位。这里我们再详细简介下元素定位的几种方法。

由于小程序是类Web的方式,大家做元素选择是,可以先了解下CSS选择器的一些基础知识 ,可参考

minium 可以通过 WXSS 选择器定位元素,一般有以下几种类型:

  • 选择器 selector (id/class/标签/属性等)
    特别的class、id等属性选择器定位,例如
<view class="child">test</view>
  • 选择器 selector + inner_text/text_contains/value
    元素属性或标签定位以及元素内的文本定位,例如
<view class="child">test</view>
<view>test2</view>
  • XPath定位
    在开发者工具中获取元素XPath,可以右键选择 Copy,点击 Copy XpathCopy full Xpath
  • 跨自定义组件的后代选择器(用>>>连接自定义组件元素)
<test22>
<view>xxx</view>
</test22>

各种定位方式推荐用法

  • xpath:推荐使用完整的xpath(full Xpath)路径,不带 “//” 这一类的写法, 有助于提高搜索速度
  • selector:推荐使用id/class/标签+属性inner_text/text_contains/value为增强用法,实现本质还是通过selector获取到元素后再通过inner_text/text_contains/value筛选元素
  • 跨自定义组件的元素获取方法:推荐使用xpath的方式。选择器方式实现是需要先获取到自定义组件再寻找其符合条件的子组件

小程序内置组件定位方式

例如小程序页面wxml

在这里插入图片描述

1. 定位 class="child" 的第2个元素

minium脚本几种写法

# 1. 耗时较短
get_element("/page/view[6]/view")  # xpath 

# 2.耗时较长
ele = get_elements("view[class='child']")[1]   # 返回第2个class=child的元素

# 3.耗时最长
get_element(".child",inner_text="parent>child")   # class=child,控件内文本为parent>child
2. 定位 class="testclass"的第1个元素

minium脚本写法

1.耗时较短
get_element("/page/view[2]")  # xpath
2.耗时较长
get_element("view[class='testclass']")   # 返回第一个class=testclass的元素
3.耗时最长
get_element(".testclass",inner_text="test class 2")  # class=testclass,控件内文本为test class 2
3. 定位没有属性的元素

在这里插入图片描述

minium脚本写法

1.耗时较短
get_element("/page/view[1]")  # xpath
2.耗时较长
get_element("view",inner_text="first node")  # view标签,控件内文本为first node

跨自定义组件元素定位方式

如何识别自定义组件
  1. 看wxml文件或微信开发者工具的wxml pannel,标签名字不在小程序官方组件列表中的都是 自定义组件
  2. 看微信开发者工具的wxml pannel, 标签下面有 #shadow-root 的, 则为 自定义组件 。例如小程序页面wxml中 mytesttest2test22

在这里插入图片描述

1. 定位 test2 标签下的 text 的元素

minium脚本写法

1.耗时较短
get_element("/page/mytest//test2//view/view/text")  # xpath
2.耗时较长
get_element("mytest>>>test2>>>text")   # 自定义组件 mytest组件节点下的test2组件节点下text标签
3.耗时最长
# 逐个获取自定义组件及自定义组件下的标签
get_element("mytest").get_element("test2").get_element("#test2").get_element("text")
2. 定位 test22标签下的第1个view的元素

minium脚本写法

1.耗时较短
get_element("/page/mytest//test22/view")  # xpath
2.耗时较长
get_element("mytest>>>test22>>>view")  # 自定义组件 mytest组件节点下的test2组件节点下text标签
3.耗时最长
# 逐个获取自定义组件及自定义组件下的标签
get_element("mytest").get_element("test22").get_element(".test22")

总结

如何缩短元素查找时间

例如该用例中获取元素方式,查找慢,会导致用例执行时长较长
get_element("view", inner_text="xxx", max_timeout=5)

元素定位用基础标签view、text方式,时间相对会长,建议用特别的class等css选择器定位,或者尝试用xpath(//view)

选择定位方式
  • 若小程序页面结构不经常发生变化,可优先使用XPath定位
  • 部分项目由于工程打包后,元素class、id等属性会随机变化,考虑使用XPath定位,或者标签+文本定位
  • 若元素class、id等属性不会随机变化,且有一定标识性,可考虑选择器定位,或者XPath定位
  • 若元素没有属性,则可考虑XPath,或标签+文本定位
  • 自定义组件定位优先考虑XPath,其次考虑跨自定义组件的后代选择器

需要帮助

### 微信小程序测试平台及相关工具 微信小程序作为一种轻量级的应用形式,其开发和测试过程需要依赖特定的工具链来完成。以下是关于基于微信小程序的测试平台、工具以及框架的相关信息。 #### 官方支持的小程序测试环境 官方提供了 **微信开发者工具** 来辅助开发者进行小程序的功能实现与调试工作[^1]。该工具内置了模拟器功能,能够帮助开发者在本地环境中预览并测试小程序的表现效果。通过扫描二维码登录的方式绑定开发者账号后,即可利用此工具中的调试面板查看网络请求、页面渲染性能以及其他运行状态数据。 为了进一步提升测试效率,微信团队还推出了专门针对自动化测试需求的支持方案——即 WeTest 平台下的「云真机」服务[^2]。这项服务允许用户远程调用真实的手机设备执行复杂的交互操作场景验证,从而弥补单纯依靠虚拟仿真可能存在的局限性。 #### 自动化测试框架推荐 对于希望构建更全面质量保障体系的企业而言,则可考虑引入第三方开源项目或者自行定制脚本逻辑来进行深层次覆盖分析: - **Minium Framework**: 这是一个由腾讯内部孵化出来的跨端UI自动化测试框架, 支持Web/H5/Applet等多种前端形态的一体化解法设计思路[^3]. Minium 提供了一套简洁易懂的操作API集合,使得即使是初学者也能快速上手编写相应的断言规则集。 - **Wetest SDK**: 结合Weixin Mini Program Simulator API接口文档说明材料[^4], 开发者可以直接嵌入到自己的持续集成流水线当中去自动触发回归检查流程而无需额外配置复杂参数选项列表. 另外值得注意的是,在实际应用过程中还需要特别关注以下几个方面因素的影响程度评估: - 不同版本客户端兼容性的考量; - 网络条件切换下用户体验流畅度保持情况检测 ; - 多媒体资源加载速度优化建议指导方针遵循状况审查等等... ```javascript // 使用minium框架的一个简单例子展示如何定位元素并点击它 const minium = require('minium'); (async () => { let driver = await minium(); await driver.init(); // 初始化driver实例 const element = await driver.$("#testButton"); if (element){ console.log("找到按钮"); await element.click(); // 执行点击动作 }else{ throw new Error("未发现目标控件!"); } })(); ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值