微信小程序自动化测试框架 Minium——PO模式测试用例-Toy模板网

这篇具有很好参考价值的文章主要介绍了微信小程序自动化测试框架 Minium——PO模式测试用例。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

本文主要介绍PO模式的测试用例，PO模式优点及层级间的关系，相关配置及运行

minitest的测试小程序和测试case：minitest-demo

miniprogram-demo：测试小程序
testcase：测试case，同时也包含文档的测试case
testcase-PO：Page Object(PO) 模式的测试case

PO简介

PO模式是自动化测试项目开发实践的最佳设计模式之一。通过对界面元素的封装减少冗余代码，同时在后期维护中，若元素定位发生变化，只需要调整页面元素封装的代码，提高测试用例的可维护性、可读性。

优点：

减少代码冗余
业务和实现分离
降低维护成本

PO用例层级

基础层base，初始化、封装Minium的原生方法

BaseCase：初始化Minium实例，继承MiniTest类
BaseDef：封装Minium的页面跳转、元素定位等方法

操作层pages，页面对象层，各页面的元素定位，操作等

BasePage：封装公用页面基础操作方法，继承BaseDef类
HomePage：首页相关元素定位及相关操作等，继承BaseDef类

测试用例层，主要负责业务逻辑和数据驱动（继承BaseCase类，初始化BasePage、HomePage类）

AppTest：测试hook用例
ElementTest：测试操作不同组件用例
LoginTest：测试登录授权用例
NativeTest：测试处理原生控件用例
PageTest：测试页面元素定位用例

BaseCase基类

测试用例基类，继承MiniTest类。复写minium.MiniTest类里面的setUpClass、tearDownClass、setUp、tearDown方法

class BaseCase(minium.MiniTest):
    """
    初始化Minium实例，测试用例基类
    """

    @classmethod
    def setUpClass(cls):
        super(BaseCase, cls).setUpClass()

    @classmethod
    def tearDownClass(cls):
        super(BaseCase, cls).tearDownClass()

    def setUp(self):
        pass

    def tearDown(self):
        pass

BaseDef公用方法类

封装Minium的页面跳转、元素定位等方法

class BaseDef:
    """
    封装Minium的页面跳转、元素定位等方法
    """

    def __init__(self, mini):
        """
        基类初始化 Minium 实例
        """
        self.mini = mini

    def navigate_to_page(self, route):
        """
        跳转到指定页面
        """
        self.mini.app.navigate_to(route)
        ret = self.wait_page(route)
        return ret

    def redirect_to_page(self, route):
        """
        跳转到指定页面并关闭当前页面
        """
        self.mini.app.redirect_to(route)
        ret = self.wait_page(route)
        return ret

	## ...

/pages 页面对象类

页面对象层，各页面的元素定位，操作等

BasePage基础页面对象类

封装公用页面基础操作方法，继承BaseDef类。例如hook wx API接口，点击元素，获取回调；hook 原生控件弹窗，点击元素，处理弹窗，获取回调等

class BasePage(base_def.BaseDef):
    """
    封装公用页面基础操作方法
    """

    def hook_wx_method(self, method, selector):
        """
        封装hook wx API接口，获取回调
        :param method: API接口
        :param selector: 触发元素选择器
        :return: 信号量，回调信息
        """
        called = threading.Semaphore(0)  # 信号量
        callback_args = None

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

        # hook wx API接口，获取回调后执行callback
        self.mini.app.hook_wx_method(method, callback=callback)
        # 点击元素
        self.mini.page.get_element(selector).tap()
        is_called = called.acquire(timeout=10)
        # 释放hook
        self.mini.app.release_hook_wx_method(method)
        return is_called, callback_args

	## ...

HomePage首页页面对象类

首页相关元素定位及相关操作等，继承BaseDef类

微信小程序测试用例,微信小程序自动化测试框架,微信小程序,测试用例,小程序

class HomePage(base_def.BaseDef):
    """
    首页相关元素定位及相关操作等
    """

    locator = {
        'app': '/page/view/navigator[1]/button',  # App接口测试
        'page': '/page/view/navigator[2]/button',  # Page接口测试
        'element': '/page/view/navigator[3]/button',  # Element接口测试
        'native': '/page/view/navigator[4]/button',  # Native接口测试
    }

    # 进入不同接口测试
    def interface_page(self, key):
        ele = self.mini.page.get_element(self.locator[key])
        ele.tap()
        ret = False
        if key == 'app':
            ret = self.wait_page(router.appPage)
        elif key == 'page':
            ret = self.wait_page(router.pagePage)
        elif key == 'element':
            ret = self.wait_page(router.elementPage)
        elif key == 'native':
            ret = self.wait_page(router.nativePage)

        return ret

/test测试用例类

主要负责业务逻辑和数据驱动

AppTest

app页面测试用例，测试hook调用

class AppTest(BaseCase):

    def setUp(self) -> None:
        super().setUp()
        # 页面跳转
        self.HomePage.interface_page("app")

    def __init__(self, methodName='runTest'):
        """
        初始化AppTest类，初始化基础页、首页类
        """
        super(AppTest, self).__init__(methodName)
        self.HomePage = home_page.HomePage(self)
        self.BasePage = base_page.BasePage(self)

    def test_hook_wx_method(self):
        """
        hook 小程序方法 getSystemInfo
        :return:
        """
        is_called, callback_args = self.BasePage.hook_wx_method("getSystemInfo", "#testhook1")
        self.assertTrue(is_called, "callback called")
        self.assertDictContainsSubset(
            {"errMsg": "getSystemInfo:ok"}, callback_args[0], "getSystemInfo"
        )

ElementTest

element页面测试用例，测试操作不同组件用例

class ElementTest(BaseCase):

    def setUp(self) -> None:
        super().setUp()
        # 页面跳转
        self.HomePage.interface_page("element")

    def __init__(self, methodName='runTest'):
        """
        初始化ElementTest类，初始化基础页、首页类
        """
        super(ElementTest, self).__init__(methodName)
        self.HomePage = home_page.HomePage(self)
        self.BasePage = base_page.BasePage(self)

    def test_move(self):
        """
        movable-view 容器拖拽滑动
        """
        ele = self.BasePage.get_element_selector("movable-view")
        # reset 重置
        ele.move_to(0, 0)  # 把movable-view复位
        time.sleep(2)
        rect = ele.rect  # 记录初始位置
        self.logger.warn(rect)
        ele.move_to(20, 100)  # 移动到坐标为20, 100的地方
        time.sleep(2)
        self.assertDictContainsSubset(
            {
                "left": 20 + rect.x,
                "top": 100 + rect.y,
            },
            ele.rect,
        )
				
	## ...

LoginTest

login页面测试用例，测试登录授权用例

class LoginTest(BaseCase):

    @classmethod
    def setUpClass(cls) -> None:
        super().setUpClass()
        try:
            # 清空授权
            cls.mini.clear_auth()
        except:
            pass

    def setUp(self) -> None:
        super().setUp()
        # 页面跳转
        self.HomePage.switch_to_tabbar("/pages/mine/mine")

    def __init__(self, methodName='runTest'):
        """
        初始化登录类，初始化基础页、首页类
        """
        super(LoginTest, self).__init__(methodName)
        self.HomePage = home_page.HomePage(self)
        self.BasePage = base_page.BasePage(self)

    def test_wechat_login(self):
        """
        微信登录
        """
        self.BasePage.get_element_xpath("/page/view/navigator[1]/button").tap()
        time.sleep(2)
        ret = self.BasePage.wait_page(router.loginPage)
        self.assertTrue(ret, "页面跳转")

        # hook 页面方法,并获取回调信息
        is_called, callback_args = self.BasePage.hook_native_method(
            method="getUserProfile",
            selector="/page/view/button",
            attr_method="allow_get_user_info")

        self.assertTrue(is_called, "callback called")
        self.assertDictContainsSubset(
            {"errMsg": "getUserProfile:ok"}, callback_args[0], "授权用户信息")
			
	## ...

NativeTest

native页面测试用例，测试处理原生控件用例

class NativeTest(BaseCase):

    @classmethod
    def setUpClass(cls) -> None:
        super().setUpClass()
        try:
            # 清空授权
            cls.mini.clear_auth()
        except:
            pass

    def setUp(self) -> None:
        super().setUp()
        # 页面跳转
        self.HomePage.interface_page("native")

    def __init__(self, methodName='runTest'):
        """
        初始化NativeTest类，初始化基础页、首页类
        """
        super(NativeTest, self).__init__(methodName)
        self.HomePage = home_page.HomePage(self)
        self.BasePage = base_page.BasePage(self)


    def test_01_show_modal(self):
        """
        showModal弹框授权
        :return:
        """
        is_called, callback_args = self.BasePage.hook_native_method(
            method="showModal",
            selector="#testModal",
            attr_method="handle_modal")

        self.assertTrue(is_called, "callback called")
        # 小程序API showModal方法回调信息断言
        self.assertDictContainsSubset(
            {"errMsg": "showModal:ok"}, callback_args[0]
        )
		
	## ...

PageTest

page页面测试用例，测试页面元素定位用例

class PageTest(BaseCase):

    def setUp(self) -> None:
        super().setUp()
        # 页面跳转
        self.HomePage.interface_page("page")

    def __init__(self, methodName='runTest'):
        """
        初始化PageTest类，初始化基础页、首页类
        """
        super(PageTest, self).__init__(methodName)
        self.HomePage = home_page.HomePage(self)
        self.BasePage = base_page.BasePage(self)

    def test_custom_element(self):
        """
        自定义组件定位
        """
        ele = self.BasePage.get_element_custom("mytest>>>test2>>>text")
        self.assertEqual("this is test2", ele.inner_text, "元素定位")
		
	## ...

config.json配置

{
  "project_path":"D:\\Program Files\\workspace\\miniApplet\\miniprogram-demo",
  "dev_tool_path":"D:\\download\\devtools\\微信web开发者工具\\cli.bat",
  "platform": "ide",
  "outputs": "outputs"
}

测试计划suit.json配置

配置需要执行的内容和顺序，以及所在的包。

pkg_list 字段说明要执行用例的内容和顺序， pkg_list 是一个数组，每个数组元素是一个匹配规则，会根据 pkg 去匹配包名，找到测试类，然后再根据 case_list 里面的规则去查找测试类的测试用例。可以根据需要编写匹配的粒度。注意匹配规则不是正则表达式，而是通配符文章来源地址https://www.toymoban.com/news/detail-726966.html

{
  "pkg_list": [
    {
      "case_list": [
        "test_*"
      ],
      "pkg": "test.*_test"
    }
  ]
}

运行

// 按照suite.json测试计划执行，输出报告
minitest -c config.json -s suite.json -g       
// 执行page_test中的测试用例
minitest -c config.json -m test.page_test -g 
// 执行page_test中的测试用例test_custom_element用例
minitest -c config.json -m test.page_test --case test_custom_element