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

最新推荐文章于 2025-06-06 15:05:27 发布

WXMiniTest

最新推荐文章于 2025-06-06 15:05:27 发布

阅读量1.9k

点赞数

CC 4.0 BY-SA版权

分类专栏：微信小程序自动化测试框架文章标签：微信小程序测试用例小程序

本文链接：https://blog.youkuaiyun.com/WXMiniTest/article/details/128729519

微信小程序自动化测试框架专栏收录该内容

10 篇文章

订阅专栏

本文介绍了PO模式在自动化测试项目中的使用，包括其减少代码冗余、分离业务与实现、降低维护成本的优点。文章详细阐述了PO模式的层级结构，如基础层、操作层和测试用例层，并展示了如何通过BaseCase和BaseDef类进行初始化和方法封装。此外，还提供了页面对象如HomePage的实现示例，以及测试用例如AppTest、ElementTest等的编写方式。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

本文主要介绍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 里面的规则去查找测试类的测试用例。可以根据需要编写匹配的粒度。注意匹配规则不是正则表达式，而是通配符

{
  "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