【小程序自动化Minium】二、元素定位-Page接口中的 get_element() 与 get_elements()

UI自动化中的重要工作就是元素定位了，高效精准的定位方法可以让工作事半功倍。

在过去的一段web自动化经历中，使用的

selenium

库支持了多种定位方法，我们可以利用这些定位方法来做进一步封装，写出符合项目更高效的定位器。

一、get_element() 与 get_elements()

那么在小程序的

Minium

框架中，是如何定位元素的呢？先来回归下上一节中演示用的代码：

import minium

class ComponentTest(minium.MiniTest):
    def test_ui_op(self):
        self.page.get_element("view", inner_text="视图容器").click()
        self.page.get_element(".navigator-text", inner_text="swiper").click()
        self.page.get_elements("switch")[0].click()
        self.page.get_elements("switch")[1].click()
        print("test_ui_op执行测试")
        print(self.mini.get_system_info())

代码里的

get_element

和

get_elements

就是框架中

Page

接口提供的方法，可以用来获取元素。

• get_element：在当前页面查询控件, 如果匹配到多个结果, 则返回第一个匹配到的结果
• get_elements: 在当前页面查询控件, 并返回一个或者多个结果

顾名思义，

get_elements

多加了个

s

表示负数，方法返回的是元素

element

对象组成的

list

，在代码里

print

出来后是这样的(手动换行方便查看)：

[
 <minium.miniprogram.base_driver.element.FormElement object at 0x000002C26893AE50>,
 <minium.miniprogram.base_driver.element.FormElement object at 0x000002C26893AAC0>
]

在这2个方法里还存在

几个相同

的参数：

以及

一个不同

的参数，这个是

get_elements

方法用到的：

二、参数介绍

1.参数：selector

这是一个必填的参数，内容是

css选择器

或以

/

或

//

开头的

xpath

，定位元素主要也是靠这个参数。

框架支持多种选择器，示例代码中的选择器就是

".navigator-text"

，关于选择器下一章再详细介绍。

而关于

xpath

，目前看官方介绍是说暂时不支持一些

[text()='xxx']

这类xpath条件，目前就先不做优先介绍了，使用CSS选择器也足够了。

另外，也可以自行搜索

xpath

语法进一步了解，以前在做web ui自动化的时候我是很热衷于使用

xpath

定位的，辅以

xpath轴

，定位器写的很好用。

2.参数：inner_text

非必填参数，默认

None

，可以通过控件内的文字识别控件。

self.page.get_element("view", inner_text="视图容器").click()

在示例代码中，

inner_text="视图容器"

指的就是小程序上出现的控件文本内容，很多时候我们可以根据这种特征进一步帮助定位。

3.参数：text_contains

非必填参数，默认

None

，可以通过控件内的文字模糊匹配控件。

跟上面的

inner_text

参数一样，只不过这里可以模糊匹配，也就是说在页面可以确定文本内容唯一的情况下，这2种写法是等价的。

self.page.get_element("view", inner_text="视图容器").click()
self.page.get_element("view", text_contains="图容").click()

4.参数：value

非必填参数，默认

None

，可以通过控件的 value 识别控件。

比如这个单选框控件，可以使用微信开发者工具的选择元素按钮，点击控件。

通过 value 值来定位的话可以这样写：

self.page.get_element("radio", value="radio1").click()

但是这里一直出现报错

TypeError: 'str' object is not callable

，是在源码

page.py

第319行。

后来我去翻阅了官方issues，找到一个2年前有人提出的问题跟我这个很像，但是官方也没回复问题关闭了。这里我也就尝试修改了一下，才能正常定位。

我重新把这个问题提交了下，如果得到回复届时再更新出来。

5.参数：max_timeout

默认值是

0

，表示超时时间，单位是

s

。而在超时之前会

每隔一秒重试一次

。

示例中，我修改下定位，使其必然定位不到。那么加了

max_timeout=5

之后，就会等待5s，期间一直定位不到的话，则抛出元素不存在错误。

self.page.get_element(".navigator-text", inner_text="form1", max_timeout=5).click()

6.参数：index

默认值为

-1

。

• index==-1: 获取所有符合的元素,
• index>=0: 获取前index+1符合的元素。

简单来说，

get_elements()

获取的是元素在一个

list

中，注意下列表中索引是从0开始的。

上图中class为

kind-list-item

存在9个元素，现在使用

get_elements

获取前2个元素：

    def test_ui_op(self):
        print(self.page.get_elements("view.kind-list-item", index=2))

遗憾的是运行结果结束仍然返回了9个元素出来，继续给官方提了个issues，等待回复吧 T_T。