【小程式自動化Minium】二、元素定位-Page介面中的 get_element() 與 get_elements()

把蘋果咬哭的測試筆記發表於2022-06-30

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_elementget_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。

相關文章