腾讯出品小程序自动化测试框架【Minium】系列（四）API详解（上）

V2AS问路

腾讯出品小程序自动化测试框架【Minium】系列（四）API详解（上）

阅读原文时间：2023年07月08日阅读：1

写在前面

不知道是不是因为之前出过书的原因，在写教程之类的文章，会潜意识有自带目录和章节的感觉在里面，有点说不出的感觉吧。

上篇文章我们介绍了关于元素定位的使用方法，这篇文章将为大家分享关于Minium中Minium、App模块的API 使用。

常用API使用详解

get_system_info()

获取系统信息

shutdown()

测试结束时调用, 停止微信开发者IDE 以及 minium, 并回收资源。一般供测试框架调用

screen_shot()

截图

ide上仅能截取到wxml页面的内容，Modal/Actionsheet/授权弹窗等无法截取

Parameters:

名称

类型

默认值

说明

save_path

str

Not None

截图保存路径

format

str

raw

截图数据返回格式，raw 或者 pillow

示例代码如下：

def test_screen_shot(self):
    """
    截图操作
    :return:
    """
    output_path = os.path.join(os.path.dirname(__file__), "outputs/test_screen_shot.png")
    print(output_path)
    if not os.path.isdir(os.path.dirname(output_path)):
        os.mkdir(os.path.dirname(output_path))
    if os.path.isfile(output_path):
        os.remove(output_path)
    ret = self.app.screen_shot(output_path)  # 截图并存到`output_path`文件夹中
    self.assertTrue(os.path.isfile(output_path))

evaluate()

向 app Service 层注入代码并执行

真机调试2.0下, 注入的代码只支持es5的语法

Parameters:

名称

类型

默认值

说明

app_function

str

Not None

代码字符串

args

list

Not None

参数

sync

bool

False

是否同步执行

Returns:

sync == True: dict(result={"result": 函数返回值})
sync == False: str(消息ID)。配合get_async_response用获取返回值

示例代码如下：

import minium

# sync == True
@minium.ddt_class
class TestApp(minium.MiniTest):
    @minium.ddt_case([], ["1", "2"])
    def test_evaluate_sync(self, args):
        result = self.app.evaluate(
            "function(){args=arguments;return 'test evaluate: '.concat(Array.from(args));}", args, sync=True
        )
        self.assertEqual(
            result.get("result", {}).get("result"), "test evaluate: {}".format(",".join(args))
        )

get_async_response()

获取evaluate方法异步调用的结果

Parameters:

名称

类型

默认值

说明

msg_id

str

Not None

evaluate返回的消息ID

timeout

int

None

等待超时时间，None: 立刻返回

示例代码如下：

import minium

# sync == False
@minium.ddt_class
class TestApp(minium.MiniTest):
    @minium.ddt_case([], ["1", "2"])
    def test_evaluate_async(self, args):
        msg_id = self.app.evaluate(
            "function(){args=arguments;return 'test evaluate: '.concat(Array.from(args));}", args, sync=False
        )
        # 你可以做一些其他操作后, 再通过get_async_response方法获取前面注入代码的运行结果
        result = self.app.get_async_response(msg_id, 5)
        self.assertEqual(
            result.get("result", {}).get("result"), "test evaluate: {}".format(",".join(args))
        )

get_all_pages_path()

获取所有已配置的页面路径

Returns:

list

示例代码如下：

def test_get_all_pages_path(self):
    """
    获取所有已配置的页面路径
    :return:list
    """
    all_pages_path = self.app.get_all_pages_path()
    self.assertListEqual(
        ['page/component/index', 'page/API/index', 'page/cloud/index', 'page/extend/index', 'page/animation/index',
         'packageComponent/pages/view/view/view', 'packageComponent/pages/view/scroll-view/scroll-view',
         'packageComponent/pages/view/swiper/swiper', 'packageComponent/pages/view/movable-view/movable-view',
         'packageComponent/pages/view/cover-view/cover-view', 'packageComponent/pages/content/text/text',
         'packageComponent/pages/content/icon/icon', 'packageComponent/pages/content/progress/progress',
         'packageComponent/pages/content/rich-text/rich-text', 'packageComponent/pages/form/button/button',
         'packageComponent/pages/form/checkbox/checkbox', 'packageComponent/pages/form/form/form',
         'packageComponent/pages/form/input/input', 'packageComponent/pages/form/label/label',
         'packageComponent/pages/form/picker/picker', 'packageComponent/pages/form/picker-view/picker-view',
         'packageComponent/pages/form/radio/radio', 'packageComponent/pages/form/slider/slider',
         'packageComponent/pages/form/switch/switch', 'packageComponent/pages/form/textarea/textarea',
         'packageComponent/pages/form/editor/editor', 'packageComponent/pages/nav/navigator/navigator',
         'packageComponent/pages/nav/navigator/navigate', 'packageComponent/pages/nav/navigator/redirect',
         'packageComponent/pages/media/image/image', 'packageComponent/pages/media/video/video',
         'packageComponent/pages/media/camera/camera', 'packageComponent/pages/media/live-pusher/live-pusher',
         'packageComponent/pages/media/live-player/live-player', 'packageComponent/pages/map/map/map',
         'packageComponent/pages/canvas/canvas-2d/canvas-2d', 'packageComponent/pages/canvas/webgl/webgl',
         'packageComponent/pages/open/ad/ad', 'packageComponent/pages/open/open-data/open-data',
         'packageComponent/pages/open/web-view/web-view',
         'packageComponent/pages/obstacle-free/aria-component/aria-component',
         'packageComponent/pages/doc-web-view/doc-web-view', 'packageAPI/pages/api/login/login',
         'packageAPI/pages/api/get-user-info/get-user-info', 'packageAPI/pages/api/request-payment/request-payment',
         'packageAPI/pages/api/jump/jump', 'packageAPI/pages/api/share/share',
         'packageAPI/pages/api/share-button/share-button', 'packageAPI/pages/api/custom-message/custom-message',
         'packageAPI/pages/api/subscribe-message/subscribe-message',
         'packageAPI/pages/api/choose-address/choose-address',
         'packageAPI/pages/api/choose-invoice-title/choose-invoice-title',
         'packageAPI/pages/api/soter-authentication/soter-authentication', 'packageAPI/pages/api/setting/setting',
         'packageAPI/pages/ar/visionkit-basic/visionkit-basic',
         'packageAPI/pages/ar/visionkit-basic-v2/visionkit-basic-v2', 'packageAPI/pages/ar/plane-ar/plane-ar',
         'packageAPI/pages/ar/plane-ar-v2/plane-ar-v2', 'packageAPI/pages/ar/plane-ar-3dof/plane-ar-3dof',
         'packageAPI/pages/ar/2dmarker-ar/2dmarker-ar', 'packageAPI/pages/ar/3dmarker-ar/3dmarker-ar',
         'packageAPI/pages/ar/osd-ar/osd-ar', 'packageAPI/pages/ar/face-detect/face-detect',
         'packageAPI/pages/ar/body-detect/body-detect', 'packageAPI/pages/ar/hand-detect/hand-detect',
         'packageAPI/pages/ar/ocr-detect/ocr-detect', 'packageAPI/pages/ar/photo-ocr-detect/photo-ocr-detect',
         'packageAPI/pages/ar/photo-hand-detect/photo-hand-detect',
         'packageAPI/pages/ar/photo-body-detect/photo-body-detect',
         'packageAPI/pages/ar/photo-face-detect/photo-face-detect',
         'packageAPI/pages/page/set-navigation-bar-title/set-navigation-bar-title',
         'packageAPI/pages/page/navigation-bar-loading/navigation-bar-loading',
         'packageAPI/pages/page/navigator/navigator', 'packageAPI/pages/page/pull-down-refresh/pull-down-refresh',
         'packageAPI/pages/page/animation/animation', 'packageAPI/pages/page/action-sheet/action-sheet',
         'packageAPI/pages/page/modal/modal', 'packageAPI/pages/page/toast/toast',
         'packageAPI/pages/page/canvas/canvas', 'packageAPI/pages/page/get-wxml-node-info/get-wxml-node-info',
         'packageAPI/pages/page/page-scroll/page-scroll',
         'packageAPI/pages/page/intersection-observer/intersection-observer',
         'packageAPI/pages/device/clipboard-data/clipboard-data', 'packageAPI/pages/device/bluetooth/bluetooth',
         'packageAPI/pages/device/bluetooth/slave/slave',
         'packageAPI/pages/device/screen-brightness/screen-brightness', 'packageAPI/pages/device/vibrate/vibrate',
         'packageAPI/pages/device/add-contact/add-contact', 'packageAPI/pages/device/wifi/wifi',
         'packageAPI/pages/device/get-network-type/get-network-type',
         'packageAPI/pages/device/on-network-status-change/on-network-status-change',
         'packageAPI/pages/device/get-system-info/get-system-info',
         'packageAPI/pages/device/on-compass-change/on-compass-change',
         'packageAPI/pages/device/make-phone-call/make-phone-call', 'packageAPI/pages/device/scan-code/scan-code',
         'packageAPI/pages/device/on-accelerometer-change/on-accelerometer-change',
         'packageAPI/pages/device/capture-screen/capture-screen', 'packageAPI/pages/device/ibeacon/ibeacon',
         'packageAPI/pages/device/get-battery-info/get-battery-info', 'packageAPI/pages/media/image/image',
         'packageAPI/pages/media/voice/voice', 'packageAPI/pages/media/file/file',
         'packageAPI/pages/media/load-font-face/load-font-face',
         'packageAPI/pages/media/background-audio/background-audio', 'packageAPI/pages/media/video/video',
         'packageAPI/pages/media/audio/audio', 'packageAPI/pages/media/media-container/media-container',
         'packageAPI/pages/location/get-location/get-location',
         'packageAPI/pages/location/open-location/open-location',
         'packageAPI/pages/location/choose-location/choose-location', 'packageAPI/pages/network/request/request',
         'packageAPI/pages/network/web-socket/web-socket', 'packageAPI/pages/network/upload-file/upload-file',
         'packageAPI/pages/network/download-file/download-file', 'packageAPI/pages/network/mdns/mdns',
         'packageAPI/pages/network/udp-socket/udp-socket', 'packageAPI/pages/storage/storage/storage',
         'packageAPI/pages/storage/get-background-fetch-data/get-background-fetch-data',
         'packageAPI/pages/storage/get-background-prefetch-data/get-background-prefetch-data',
         'packageAPI/pages/performance/get-performance/get-performance', 'packageAPI/pages/worker/worker/worker',
         'packageAPI/pages/framework/two-way-bindings/two-way-bindings', 'packageAPI/pages/framework/wxs/wxs',
         'packageAPI/pages/framework/resizable/resizable', 'packageAPI/pages/framework/wxs/movable',
         'packageAPI/pages/framework/wxs/sidebar', 'packageAPI/pages/framework/wxs/stick-top',
         'packageAPI/pages/framework/wxs/nearby', 'packageAPI/pages/ai/mobilenet/index',
         'packageAPI/pages/ai/style-trans/index', 'packageCloud/pages/user/user-authentication/user-authentication',
         'packageCloud/pages/database/crud/crud', 'packageCloud/pages/database/db-permission/db-permission',
         'packageCloud/pages/database/server-date/server-date',
         'packageCloud/pages/storage/upload-file/upload-file',
         'packageCloud/pages/storage/download-file/download-file',
         'packageCloud/pages/storage/get-temp-file-url/get-temp-file-url',
         'packageCloud/pages/storage/delete-file/delete-file',
         'packageCloud/pages/storage/cloud-file-component/cloud-file-component',
         'packageCloud/pages/scf/get-wx-context/get-wx-context', 'packageCloud/pages/scf/scf-database/scf-database',
         'packageCloud/pages/scf/scf-storage/scf-storage', 'packageCloud/pages/scf/scf-openapi/scf-openapi',
         'packageExtend/pages/form/cell/cell', 'packageExtend/pages/form/slideview/slideview',
         'packageExtend/pages/form/form/form', 'packageExtend/pages/form/uploader/uploader',
         'packageExtend/pages/base/article/article', 'packageExtend/pages/base/icons/icons',
         'packageExtend/pages/base/badge/badge', 'packageExtend/pages/base/flex/flex',
         'packageExtend/pages/base/footer/footer', 'packageExtend/pages/base/gallery/gallery',
         'packageExtend/pages/base/grid/grid', 'packageExtend/pages/base/loadmore/loadmore',
         'packageExtend/pages/base/loading/loading', 'packageExtend/pages/base/panel/panel',
         'packageExtend/pages/base/preview/preview', 'packageExtend/pages/operate/dialog/dialog',
         'packageExtend/pages/operate/msg/msg', 'packageExtend/pages/operate/msg/msg_success',
         'packageExtend/pages/operate/msg/msg_text', 'packageExtend/pages/operate/msg/msg_text_primary',
         'packageExtend/pages/operate/msg/msg_fail',
         'packageExtend/pages/operate/half-screen-dialog/half-screen-dialog',
         'packageExtend/pages/operate/actionsheet/actionsheet', 'packageExtend/pages/operate/toptips/toptips',
         'packageExtend/pages/navigation/navigation/navigation', 'packageExtend/pages/navigation/tabbar/tabbar',
         'packageExtend/pages/search/searchbar/searchbar', 'packageExtend/pages/extend/emoji/emoji',
         'packageExtend/pages/extend/video-swiper/video-swiper', 'packageExtend/pages/extend/index-list/index-list',
         'packageExtend/pages/extend/recycle-view/recycle-view', 'packageExtend/pages/extend/sticky/sticky',
         'packageExtend/pages/extend/tabs/tabs', 'packageExtend/pages/extend/vtabs/vtabs',
         'packageExtend/pages/extend/barrage/barrage', 'packageExtend/pages/extend/select-text/select-text',
         'packageExtend/pages/extend/wxml-to-canvas/wxml-to-canvas',
         'packageExtend/pages/adapt/telescopic/telescopic', 'packageExtend/pages/adapt/linebreak/linebreak',
         'packageExtend/pages/adapt/sidenavigation/sidenavigation',
         'packageExtend/pages/adapt/pagination/pagination', 'packageExtend/pages/adapt/freelayout/freelayout',
         'packageExtend/pages/adapt/layeredpresentation/layeredpresentation',
         'packageExtend/pages/adapt/horizontalexpansion/horizontalexpansion',
         'packageSkyline/pages/worklet/animation/index', 'packageSkyline/pages/worklet/gesture/index',
         'packageSkyline/pages/worklet/bottom-sheet/index', 'packageSkyline/pages/share-element/list/index',
         'packageSkyline/pages/share-element/card/index', 'packageSkyline/pages/half-page/scale-page/index',
         'packageSkyline/pages/half-page/half-page/index', 'packageSkyline/pages/address-book/index',
         'packageSkyline/pages/half-screen/index', 'packageSkyline/pages/tabs/index',
         'packageSkyline/pages/album/index', 'packageSkyline/pages/preview/index',
         'packageSkyline/pages/custom-route/index', 'packageSkyline/pages/custom-route/detail',
         'packageSkyline/pages/scroll-view/index', 'packageXRFrame/pages/index/index',
         'packageXRFrame/pages/scene-basic/index', 'packageXRFrame/pages/scene-basic-light/index',
         'packageXRFrame/pages/scene-basic-animation/index', 'packageXRFrame/pages/scene-basic-particle/index',
         'packageXRFrame/pages/scene-basic-touch/index', 'packageXRFrame/pages/scene-basic-visible-layer/index',
         'packageXRFrame/pages/scene-basic-shadow/index', 'packageXRFrame/pages/scene-basic-video/index',
         'packageXRFrame/pages/scene-basic-render-texture/index',
         'packageXRFrame/pages/scene-basic-postprocessing/index',
         'packageXRFrame/pages/scene-gltf-damageHelmet/index', 'packageXRFrame/pages/scene-gltf-unlit/index',
         'packageXRFrame/pages/scene-gltf-animation/index', 'packageXRFrame/pages/scene-gltf-morph/index',
         'packageXRFrame/pages/scene-gltf-light-loading/index', 'packageXRFrame/pages/scene-ar-basic/index',
         'packageXRFrame/pages/scene-ar-2dmarker/index', 'packageXRFrame/pages/scene-ar-osdmarker/index',
         'packageXRFrame/pages/scene-ar-camera/index', 'packageXRFrame/pages/scene-ar-face/index',
         'packageXRFrame/pages/scene-ar-hand/index', 'packageXRFrame/pages/scene-ar-body/index',
         'packageXRFrame/pages/scene-custom-logic/index', 'packageXRFrame/pages/scene-custom-render/index',
         'packageXRFrame/pages/scene-scan-render/index', 'packageXRFrame/pages/scene-scan-team/index',
         'packageXRFrame/pages/scene-classic-wxball/index', 'packageXRFrame/pages/scene-classic-video/index',
         'packageXRFrame/pages/scene-classic-perspect/index', 'packageXRFrame/pages/scene-classic-portal/index',
         'packageXRFrame/pages/scene-classic-osd/index', 'packageXRFrame/pages/scene-classic-face/index',
         'packageXRFrame/pages/scene-last-record/index'],
        all_pages_path,
        "test ok",
    )

get_current_page()

获取当前顶层页面

Returns:

页面对象

示例代码如下：

import minium

class AppTest(minium.MiniTest):
    def test_get_current_page(self):
        page = self.app.get_current_page()  # 同self.app.current_page
        self.assertIsNotNone(page.path)
        self.assertNotEqual("", page.path)
        print(page.path)

go_home()

跳转到小程序首页

示例代码如下：

def test_go_home(self):
    """
    跳转到小程序首页
    :return:
    """
    self.page.get_element("view", inner_text="视图容器").click()
    self.page.get_element("navigator", inner_text="view").click()
    # 跳转到小程序首页
    self.app.go_home()

navigate_to()

以导航的方式跳转到指定页面

不能跳到 tabbar 页面。支持相对路径和绝对路径, 小程序中页面栈最多十层

Parameters:

名称

类型

默认值

说明

url

str

Not None

页面路径

params

dict

None

页面参数

is_wait_url_change

bool

True

是否等待新的页面跳转

个人感觉就是跳转到指定页面，也可以理解为导航栏上的超链接带路径那种的

示例代码如下：

def test_navigate_to(self):
    """
    跳转到指定页面
    :return:
    """
    pass_page = self.app.get_current_page()
    self.app.navigate_to("/packageComponent/pages/view/view/view")

navigate_back()

关闭当前页面，返回上一页面

示例代码如下：

def test_navigate_to(self):
    """
    返回上一页
    :return:
    """
    pass_page = self.app.get_current_page()
    # 跳转到指定页面
    self.app.navigate_to("/packageComponent/pages/view/view/view")
    # 返回上一页
    self.app.navigate_back()

redirect_to()

关闭当前页面，重定向到应用内的某个页面

不允许跳转到 tabbar 页面

Parameters:

名称

类型

默认值

说明

url

str

Not None

页面路径

params

dict

None

页面参数

is_wait_url_change

bool

True

是否等待新的页面跳转

个人感觉同navigate_to()用法很像，各种细节感兴趣的同学可以自行尝试。

示例代码如下：

def redirect_to(self):
    """
    重定向到指定页面
    :return:
    """
    # 重定向到指定页面
    self.app.redirect_to("/packageComponent/pages/view/view/view")

relaunch()

关闭所有页面，打开到应用内的某个页面

Parameters:

名称

类型

默认值

说明

url

str

Not None

页面路径

示例代码如下：

def test_relaunch(self):
    """
    关闭所有页面，打开到应用内的某个页面
    :return:
    """
    pass_page = self.app.get_current_page()
    # 重定向到指定页面
    self.app.redirect_to("/packageComponent/pages/view/view/view")
    # 关闭所有页面，打开到应用内的某个页面
    self.app.relaunch("/packageComponent/pages/view/movable-view/movable-view")

switch_tab()

跳转到 tabBar 页面

会关闭其他所有非tabBar页面

Parameters:

名称

类型

默认值

说明

url

str

Not None

需要跳转的 tabBar 页面的路径（需在 app.json 的 tabBar 字段定义的页面），路径后不能带参数

is_click

bool

False

切换tab的时候触发一次onTabItemTap

示例代码如下：

def switch_tab(self):
    """
    跳转到 tabBar 页面
    :return:
    """
    pass_page = self.app.get_current_page()
    print(pass_page)
    # 重定向到指定页面
    self.app.redirect_to("/packageComponent/pages/view/view/view")
    # 关闭所有页面，打开到应用内的某个页面
    self.app.relaunch("/packageComponent/pages/view/movable-view/movable-view")
    # 跳转到 tabBar 页面
    self.app.switch_tab("/page/API/index")

什么是tabbar页面？

举个栗子，比如我们小程序的底部有图标加文字的几个按钮，每个按钮对应一个页面，而整个小程序中有很多页面，小程序底部图标加文字对应的几个页面是tabbar页面，这个在app.json中有设置。

eg：在app.json中设置对应的tabbar页面

"tabBar": {
    "color": "#333",
    "selectedColor": "#d43c33",
    "backgroundColor": "#fff",
    "position": "bottom",
    "list": [
      {
        "pagePath": "pages/index/index",
        "text": "主页",
        "iconPath": "/static/images/tabs/tab-home.png",
        "selectedIconPath": "/static/images/tabs/tab-home-current.png"
      },
      {
        "pagePath": "pages/video/video",
        "text": "视频",
        "iconPath": "/static/images/tabs/select.png",
        "selectedIconPath": "/static/images/tabs/selected.png"
      },
      {
        "pagePath": "pages/personal/personal",
        "text": "个人中心",
        "iconPath": "/static/images/tabs/tab-my.png",
        "selectedIconPath": "/static/images/tabs/tab-my-current.png"
      }
    ]
  }

get_perf_time()

查询小程序的性能指标，跟stop_get_perf_time配对使用

Parameters:

名称

类型

默认值

说明

entry_types

list

Not None

可选项为['render', 'script', 'navigation', 'loadPackage']中的1个或多个

stop_get_perf_time()

结束查询，跟get_perf_time配对使用

示例代码如下：

def test_get_perf_time(self):
    """
    查询小程序的性能指标
    :return:
    """
    self.app.get_perf_time(entry_types=["navigation"])
    self.app.navigate_to("/packageComponent/pages/view/view/view")
    self.app.redirect_to("/packageComponent/pages/view/movable-view/movable-view")
    perf_data = self.app.stop_get_perf_time()
    print(perf_data)

可以看到一些路径跳转的耗时,结果如下：

[{
    'entryType': 'navigation',
    'name': 'route',
    'startTime': 1674803063419,
    'duration': 387,
    'navigationType': 'navigateTo',
    'path': 'packageComponent/pages/view/view/view',
    'pageId': 53,
    'referrerPath': 'page/component/index',
    'referrerPageId': 52,
    'navigationStart': 1674803063575
}, {
    'entryType': 'render',
    'name': 'firstRender',
    'startTime': 1674803063575,
    'duration': 74,
    'path': 'packageComponent/pages/view/view/view',
    'pageId': 53,
    'viewLayerReadyTime': 1674803063618,
    'initDataSendTime': 1674803063603,
    'initDataRecvTime': 1674803063619,
    'viewLayerRenderStartTime': 1674803063619,
    'viewLayerRenderEndTime': 1674803063646
}, {
    'entryType': 'render',
    'name': 'firstPaint',
    'startTime': 1674803063583,
    'path': 'packageComponent/pages/view/view/view',
    'pageId': 53
}, {
    'entryType': 'render',
    'name': 'firstContentfulPaint',
    'startTime': 1674803063667,
    'path': 'packageComponent/pages/view/view/view',
    'pageId': 53
}, {
    'entryType': 'render',
    'name': 'largestContentfulPaint',
    'startTime': 1674803063667,
    'path': 'packageComponent/pages/view/view/view',
    'pageId': 53
}, {
    'entryType': 'navigation',
    'name': 'route',
    'startTime': 1674803063419,
    'duration': 387,
    'navigationType': 'navigateTo',
    'path': 'packageComponent/pages/view/view/view',
    'pageId': 53,
    'referrerPath': 'page/component/index',
    'referrerPageId': 52,
    'navigationStart': 1674803063575
}, {
    'entryType': 'render',
    'name': 'firstRender',
    'startTime': 1674803063575,
    'duration': 74,
    'path': 'packageComponent/pages/view/view/view',
    'pageId': 53,
    'viewLayerReadyTime': 1674803063618,
    'initDataSendTime': 1674803063603,
    'initDataRecvTime': 1674803063619,
    'viewLayerRenderStartTime': 1674803063619,
    'viewLayerRenderEndTime': 1674803063646
}, {
    'entryType': 'render',
    'name': 'firstPaint',
    'startTime': 1674803063583,
    'path': 'packageComponent/pages/view/view/view',
    'pageId': 53
}, {
    'entryType': 'render',
    'name': 'firstContentfulPaint',
    'startTime': 1674803063667,
    'path': 'packageComponent/pages/view/view/view',
    'pageId': 53
}, {
    'entryType': 'render',
    'name': 'largestContentfulPaint',
    'startTime': 1674803063667,
    'path': 'packageComponent/pages/view/view/view',
    'pageId': 53
}, {
    'entryType': 'navigation',
    'name': 'route',
    'startTime': 1674803063419,
    'duration': 387,
    'navigationType': 'navigateTo',
    'path': 'packageComponent/pages/view/view/view',
    'pageId': 53,
    'referrerPath': 'page/component/index',
    'referrerPageId': 52,
    'navigationStart': 1674803063575
}, {
    'entryType': 'navigation',
    'name': 'route',
    'startTime': 1674803063874,
    'duration': 680,
    'navigationType': 'redirectTo',
    'path': 'packageComponent/pages/view/movable-view/movable-view',
    'pageId': 54,
    'referrerPath': 'packageComponent/pages/view/view/view',
    'referrerPageId': 53,
    'navigationStart': 1674803064353
}, {
    'entryType': 'render',
    'name': 'firstRender',
    'startTime': 1674803064353,
    'duration': 71,
    'path': 'packageComponent/pages/view/movable-view/movable-view',
    'pageId': 54,
    'viewLayerReadyTime': 1674803064393,
    'initDataSendTime': 1674803064367,
    'initDataRecvTime': 1674803064375,
    'viewLayerRenderStartTime': 1674803064394,
    'viewLayerRenderEndTime': 1674803064421
}, {
    'entryType': 'render',
    'name': 'firstPaint',
    'startTime': 1674803064358,
    'path': 'packageComponent/pages/view/movable-view/movable-view',
    'pageId': 54
}, {
    'entryType': 'render',
    'name': 'firstContentfulPaint',
    'startTime': 1674803064425,
    'path': 'packageComponent/pages/view/movable-view/movable-view',
    'pageId': 54
}, {
    'entryType': 'render',
    'name': 'largestContentfulPaint',
    'startTime': 1674803064425,
    'path': 'packageComponent/pages/view/movable-view/movable-view',
    'pageId': 54
}, {
    'entryType': 'navigation',
    'name': 'route',
    'startTime': 1674803063874,
    'duration': 680,
    'navigationType': 'redirectTo',
    'path': 'packageComponent/pages/view/movable-view/movable-view',
    'pageId': 54,
    'referrerPath': 'packageComponent/pages/view/view/view',
    'referrerPageId': 53,
    'navigationStart': 1674803064353
}, {
    'entryType': 'render',
    'name': 'firstRender',
    'startTime': 1674803064353,
    'duration': 71,
    'path': 'packageComponent/pages/view/movable-view/movable-view',
    'pageId': 54,
    'viewLayerReadyTime': 1674803064393,
    'initDataSendTime': 1674803064367,
    'initDataRecvTime': 1674803064375,
    'viewLayerRenderStartTime': 1674803064394,
    'viewLayerRenderEndTime': 1674803064421
}, {
    'entryType': 'render',
    'name': 'firstPaint',
    'startTime': 1674803064358,
    'path': 'packageComponent/pages/view/movable-view/movable-view',
    'pageId': 54
}, {
    'entryType': 'render',
    'name': 'firstContentfulPaint',
    'startTime': 1674803064425,
    'path': 'packageComponent/pages/view/movable-view/movable-view',
    'pageId': 54
}, {
    'entryType': 'render',
    'name': 'largestContentfulPaint',
    'startTime': 1674803064425,
    'path': 'packageComponent/pages/view/movable-view/movable-view',
    'pageId': 54
}, {
    'entryType': 'navigation',
    'name': 'route',
    'startTime': 1674803063874,
    'duration': 680,
    'navigationType': 'redirectTo',
    'path': 'packageComponent/pages/view/movable-view/movable-view',
    'pageId': 54,
    'referrerPath': 'packageComponent/pages/view/view/view',
    'referrerPageId': 53,
    'navigationStart': 1674803064353
}]

wait_for_page()

等待页面跳转成功

Parameters:

名称

类型

默认值

说明

page_path

str

Not None

需要等待的页面路径, 需要绝对路径, 如/pages/index

示例代码如下：

def test_wait_for_page(self):
    """
    等待页面跳转成功
    :return:布尔类型
    """
    self.page.get_element("view",inner_text='表单组件').click()
    el = self.app.current_page.get_element('navigator',inner_text='button')
    el.tap()
    current_page=self.app.get_current_page()
    time.sleep(3)
    print(current_page)
    ret = self.app.wait_for_page("/packageComponent/pages/form/button/button")
    print(ret)
    self.assertTrue(ret, "wait success")
    self.assertEqual(self.app.current_page.path, "/packageComponent/pages/form/button/button", "path ok")

wait_util()

指定时间内, 剩余没有完成的异步请求数 <= {cnt}个, 此时认为页面异步加载完成

Parameters:

名称

类型

默认值

说明

cnt

int

Not None

剩余的异步请求个数

max_timeout

int

最大等待时间

示例代码如下：

def test_wait_util(self):
    """
    确定指定时间内, 异步请求是否完成的
    :return:布尔类型
    """
    self.page.get_element("view",inner_text='表单组件').click()
    el = self.app.current_page.get_element('navigator',inner_text='button')
    el.tap()
    ret = self.app.wait_util(0, 5)  # 5s内, 页面没有任何未完成的异步请求
    self.assertTrue(ret, "wait success")

写在最后

关于Minium接口中minium、App部分的APi已经介绍完毕，这两个模块中部分Api没做分享感兴趣的同学可以到官方文章自行查看。

仔细看了下API部分还真不少，下篇文章会为大家分享Page、Element这两个模块的Api，感兴趣的同学可以蹲一下，建议收藏，也请星标我的公号（软件测试君），并帮忙转发给你更多的人，我需要你的支持，谢谢！

手机扫一扫

移动阅读更方便

你可能感兴趣的文章