騰訊出品小程式自動化測試框架【Minium】系列（六）常見元件的處理

久曲健發表於2023-02-06
框架元件

寫在前面

我發現一件神奇的事，當你學一門新技術或者新的知識點遇到不會的時候，真的可以先放一放，第二天再去學習，也許說不定也就會了。

為什麼這麼說？

昨天文章斷斷續續的寫了近一天，有一個元件不認識，自然也不知道該怎麼處理，真的憋得腦子疼，後來一合計算了，事已至此，還是先吃飯吧，就扔一邊了。

結果今天再一看，發現 居然我會了，而且一個不留神，就把小程式的官方API都給過完了，所以這就再來更新了。

常見元件的處理

switch元件處理

image.png

改變 switch 元件的狀態

示例程式碼如下：

def test_switch(self):
    '''
    switch 元件處理演示，可以腦補下單選框狀態切換場景
    :return:
    '''
    self.app.navigate_to("/packageComponent/pages/form/switch/switch")
    self.page.get_element(".page-section.page-section-gap > view.body-view > switch:nth-child(1)").switch()

slide元件處理

image.png

slider 元件滑動到指定數值

示例程式碼如下：

def test_slide_to(self):
    '''
    slider元件處理演示
    :return:
    '''
    self.app.navigate_to("/packageComponent/pages/form/slider/slider")
    element_slider = self.page.get_element('page > view > view > view:nth-child(1) > view.body-view > slider')
    element_slider.slide_to(5)
    time.sleep(1)
    self.assertEqual(element_slider.value, 5, "slider ok")

pick元件處理

image.png

picker 元件選值

Parameters:

名稱 型別 預設值 說明
value 看下錶 Not None 屬性名稱

value 的取值：

選擇器型別 型別 說明
selector: 普通選擇器 int 表示選擇了 range 中的第幾個 (下標從 0 開始)
multiSelector: 多列選擇器 int 表示選擇了 range 中的第幾個 (下標從 0 開始)
time: 時間選擇器 str 表示選中的時間，格式為"hh:mm"
date: 日期選擇器 str 表示選中的日期，格式為"YYYY-MM-DD"
region: 省市區選擇器 int 表示選中的省市區，預設選中每一列的第一個值

示例程式碼如下：

def test_picker(self):
    '''
    picker元件處理演示。修改當前時間
    :return:
    '''
    self.app.navigate_to("/packageComponent/pages/form/picker/picker")
    callback_called = threading.Semaphore(0)  # 監聽回撥, 阻塞當前主執行緒

    def callback(args):
        nonlocal callback_args
        callback_args = args
        callback_called.release()

    els = self.page.get_elements("picker")
    self.app.hook_current_page_method('bindTimeChange', callback)
    els[1].click()  # 阻止picker彈起
    els[1].pick('11:18')  # 用trigger模擬pick完成的動作

scroll_to元件處理

image.png

scroll-view 容器滾動操作

Parameters:

名稱 型別 預設值 說明
x int None x 軸上滾動的距離
y int None y 軸上滾動的距離

示例程式碼如下：

def test_scroll_to(self):
    '''
    scroll_to元件處理演示
    :return:
    '''
    self.app.navigate_to("/packageComponent/pages/view/scroll-view/scroll-view")
    callback_args = None
    callback_called = threading.Semaphore(0)  # 監聽回撥, 阻塞當前主執行緒

    def callback(args):
        nonlocal callback_args
        callback_args = args
        callback_called.release()

    # 監聽滾動事件, 方便最後驗證滾動結果
    self.app.hook_current_page_method("scroll", callback)
    # 這裡只演示的事橫向移動，主要找準你要移動的控制元件，整錯了鐵定沒法移動
    els = self.page.get_elements("scroll-view")
    els[2].scroll_to(x=150)  # 橫向滾動150畫素
    self.assertTrue(callback_called.acquire(timeout=10), "callback called")
    self.assertEqual(callback_args[0]["detail"]["scrollLeft"], 150, "pick ok")

swipe元件處理

image.png

切換 swiper 容器當前的頁面

Parameters:

名稱 型別 預設值 說明
index int None 索引值，從 0 開始

示例程式碼如下：

def test_swipe_to(self):
    '''
    swipe元件處理演示
    :return:
    '''
    self.app.navigate_to("/packageComponent/pages/view/swiper/swiper")
    el = self.page.get_element("swiper")
    # 切換到第二個tab,輪播圖的C
    el.swipe_to(2)
    print(el.attribute('current'))
    self.assertEqual(el.attribute('current'), ['2'], "swipe ok")

move元件處理

image.png

movable-view 容器拖拽滑動

Parameters:

名稱 型別 預設值 說明
x int None x 軸方向的偏移距離
y int None y 軸方向的偏移距離

PS: x,y 偏移量相對於movable-area左上角，如示例中，movable-area左上角為(25, 25)

示例程式碼如下：

def test_move_to(self):
    '''
    move元件處理演示
    :return:
    '''
    self.app.navigate_to("/packageComponent/pages/view/movable-view/movable-view")
    element = self.page.get_element("movable-view")
    # 把movable-view復位
    element.move_to(0, 0)
    time.sleep(2)
    # 移動到座標為100, 100的地方
    element.move_to(100, 100)

video、audio 元件

image.png

詳見程式碼示例

video元件處理示例程式碼如下：

def test_video(self):
    '''
    video元件處理演示
    :return:
    '''
    self.app.navigate_to("/packageComponent/pages/media/video/video")
    element_video = self.page.get_element("video")
    # 播放
    element_video.play()
    time.sleep(2)
    # 暫停
    element_video.pause()
    time.sleep(2)
    # 跳轉到指定位置(拖到50秒位置播放)
    element_video.seek(50)
    time.sleep(2)
    element_video.play()
    # 1.5倍速播放
    element_video.playback_rate(1.5)
    time.sleep(2)
    # 進入全屏播放
    element_video.request_full_screen(90)
    time.sleep(2)
    # 傳送彈幕
    element_video.send_danmu('我是彈幕君!!')
    time.sleep(2)
    # 退出全屏
    element_video.exit_full_screen()
    time.sleep(2)
    # 播放
    element_video.stop()

audio元件處理示例程式碼如下：

def test_audio(self):
    '''
    audio元件處理演示
    :return:
    '''
    self.app.navigate_to("/packageComponent/pages/media/audio/audio")
    element_audio = self.page.get_element("audio")
    element_audio.play()  # 播放音訊
    element_audio.seek(10)  # 快進音訊
    element_audio.pause()  # 暫停音訊
    element_audio.set_src('http: // ws.stream.qqmusic.qq.com / M500001VfvsJ21xFqb.mp3?guid = ffffffff82def4af4b12b3cd9337d5e7 & uin = 346897220 & vkey = 6292asdad & fromtag = 46')  # 設定音源連結

其他示例

單頁面示例

直接跳轉到被測試的頁面，進行指令碼的測試。

示例程式碼如下：

def test_set_data(self):
    '''
    單頁面示例
    :return:
    '''
    self.app.navigate_to("/packageComponent/pages/content/text/text")
    self.page.data = {
        'text': "只能加文字，不能刪除文字",
        'canAdd': True,
        'canRemove': False
    }
    time.sleep(1)
    self.capture("canAdd")
    self.page.data = {
        'text': "只能刪除文字，不能加文字",
        'canAdd': False,
        'canRemove': True
    }
    time.sleep(1)
    self.capture("canRemove")

資料驅動測試

測試框架繼承自unittest，基於ddt封裝的的簡單封裝。

示例程式碼如下：

# -*- coding: utf-8 -*-
"""
# @Time    : 2023/02/06 20:31
# @Author  : longrong.lang
# @FileName: test_base.py
# @Software: PyCharm
# @Blog    ：https://www.cnblogs.com/longronglang/
# @Motto：ABC(Always Be Coding)
"""
import minium


@minium.ddt_class
class BaseTest(minium.MiniTest):
    @minium.exit_when_error
    def test_init(self):
        """
        這條用例失敗會退出測試計劃，minium.exit_when_error可以用來修飾初始化用例
        """
        self.assertEqual(1, 1)

    @minium.ddt_case(1, 2, 3)
    def test_ddt(self, value):
        """
        資料驅動測試，這個case會自動展開成3條用例：
        test_ddt_1_1
        test_ddt_2_2
        test_ddt_3_3
        """
        self.assertIn(value, [1, 2, 3])


if __name__ == '__main__':
    BaseTest.test_ddt()

寫在最後

關於Minium使用教程已經全部更新完了，要想學習全部可以從Minium系列教程從頭學起，下篇文章將會為大家分享基於Minium的測試框架設計及開發，感興趣的同學可以蹲一下，我是六哥，覺得文章對您有用，請星標並轉發即可！

相關文章