Mastering WeChat Mini Program Testing: From Environment Setup to Automated pytest‑mini

Introduction

Mini programs provide a new way to connect users and services inside WeChat, offering convenient acquisition, sharing, and a smooth user experience.

Because many of our products are delivered via mini programs, understanding testing basics has become essential.

Overview

The article introduces basic knowledge of mini program testing and related automation practices.

Basic part: environment setup, testing fundamentals, key considerations.

Automation: using a pytest plugin that wraps the official MiniTest library.

Mini Program Testing Environment Setup

WeChat Developer Tools

Typical testing needs include viewing the mini program on different devices, inspecting request/response data, quickly verifying changes, checking JavaScript errors, and analyzing code quality, performance, and package size.

Download the IDE from the official website.

Request developer permission from the mini program owner.

Package the mini program.

Open the packaged product with WeChat Developer Tools.

Mini Program Testing Fundamentals

Rendering and Logic Layers

The rendering layer uses a WebView to display UI, while the logic layer runs JavaScript on a JsCore thread. Communication between the two layers is mediated by the native WeChat client.

Mini Program Versions

Different versions have distinct entry methods:

Development version: preview with WeChat Developer Tools; QR code valid for 30 minutes.

Experience version: managed in the platform; QR code permanent.

Release version: searchable directly in WeChat.

Startup Mechanism

WeChat caches the entire mini program (files, auth data, login data, etc.) to ensure fast access. Cache issues may arise when switching environments, publishing, or logging in/out. A simple way to clear cache is to delete the mini program and re‑enter.

Cold start: user opens the mini program for the first time or after it has been destroyed.

Hot start: user re‑opens a mini program that is still in memory, moving it from background to foreground.

External Webpage and Official Account Restrictions

During non‑release testing you can disable domain, TLS, and certificate validation, but the final version must whitelist external links. Linked articles must belong to the mini program’s associated official account.

Package Size Limits

The total size of all sub‑packages must not exceed 20 MB, and each individual sub‑package or main package must stay under 2 MB. The developer tool can display package sizes.

Performance Data

In the WeChat Developer Tools debugger, open the "Show console drawer" and click "Task" to view real‑time performance metrics.

Mock Data

Example of a mock response for a customer‑list API:

<code>{"data":"","statusCode":"","header":""}</code>

After merging additional fields:

<code>{"data":{"c":"0","m":"","d":{"pageIndex":1,"pageSize":20,"rowTotal":1,"pageTotal":1,"data":[{"obsCustomerId":"xx","customerName":"听白","customerPhone":"","designNames":null}]},"f":null},"statusCode":200,"header":""}</code>

Matching the API with a regular expression:

<code>https:\/\/xx.com\/xx\/ixx\/xx\/xx\/pagelist</code>

Testing Tips

Login‑Free Scenarios

Shared links are usually accessed without login; verify using a fresh device or cleared cache.

Top‑Right Operations

Check all functions exposed in the top‑right corner, especially floating window switches and foreground/background transitions that may cause blank screens.

Payment Functions

WeChat Pay

QR Code Pay

Third‑Party Pay

Ensure each payment method can be invoked and completed successfully.

Cache Management

Identify which data should be cached and which should not, and verify data consistency when switching pages or accounts.

Entry Validity

Searchable via the WeChat "Mini Programs" search box.

Discoverable through "Nearby Mini Programs".

Accessible from recent chats after prior use.

Openable via shared links.

Openable by scanning the mini program QR code.

Re‑discoverable after deletion.

Compatibility

Operating System Compatibility

iOS/iPadOS/macOS: logic runs on JavaScriptCore, view rendered by WKWebView.

Android: logic runs on V8, view rendered by XWeb (Mobile Chromium).

Windows: both logic and view use Chromium.

Developer tools: logic runs on NW.js, view rendered by Chromium WebView.

JavaScriptCore cannot enable JIT compilation, so its performance is noticeably lower than other platforms under the same conditions.

Device Compatibility

Screen adaptation relies on the responsive pixel unit

rpx

, which scales automatically across devices.

WeChat Version Compatibility

WeChat bundles the previous stable base library with each client version to avoid unknown impacts from newer libraries. A mini program can only run on client versions that support its declared base library.

Cross‑Event Interruption

WeChat events such as video calls may interrupt the mini program.

Phone calls, alarms, or file transfers may also interrupt execution.

The mini program does not block these events; verify that no crashes, white screens, or freezes occur.

Network Conditions

Test performance on 3G, 4G, 5G, and Wi‑Fi.

When the network is poor, ensure the app shows appropriate loading states or error messages.

Verify automatic recovery when the network switches from offline to online.

Automation Testing

pytest‑mini

Project: https://pypi.org/project/pytest-mini/

Based on MiniTest, it provides a pytest‑style interface while preserving original features.

Installation

<code>pip install pytest-mini --upgrade</code>

Project Structure

Page Elements (components_page.py)

<code>from pytest_mini import Mini, Locator

class ComponentsPage(Mini):
    view_container = Locator('view', inner_text='视图容器', desc='组件页-视图容器')
</code>

Pre‑conditions (conftest.py)

<code>import pytest
from pytest_mini import plugins
from demo.pages import ComponentsPage

pytest_plugins = plugins(
    "/Users/zhongxin/github/miniprogram-demo",  # path to the mini program project
    "/Applications/wechatwebdevtools.app/Contents/MacOS/cli"  # WeChat Developer Tools path
)

@pytest.fixture(scope="session")
def components_page(mini):
    yield ComponentsPage(driver=mini.driver)
</code>

Test Code (test_home.py)

<code>import allure
from pytest_mini import compose

@compose(feature="小程序官方组件展示", story="组件", title='容器视图操作')
def test_view_container(components_page):
    with allure.step("点击容器视图"):
        components_page.click(components_page.view_container)
        assert False, "故意失败,查看报告截图"
</code>

Demo Test Result

Real Project Test Result

Network request details can be inspected in the debugger.

Related Documentation

WeChat official documentation – Mini Programs: https://developers.weixin.qq.com/miniprogram/dev/framework/