Skip to main content
Back to trending

wxa-runner

Run mini programs in the browser using the official WeChat base library, with support for Chrome DevTools debugging and Playwright E2E testing

Translated from Chinese · show original

在浏览器中用微信官方基础库运行小程序，支持 Chrome DevTools 调试与 Playwright E2E 测试

  • e2e-testing
  • mini-program
  • miniprogram
  • playwright
  • simulator
  • taro
  • uni-app
  • weapp
  • wechat
  • wechat-miniprogram
View on GitHub
Stars
947
Forks
114
+ today
+5
Created
22d

Ranking data as of November 4, 2026 (UTC).

Star History

Today, hour by hour

947 stars
05

Overview

Run mini programs in the browser using the official WeChat base library, with support for Chrome DevTools debugging and Playwright E2E testing It ranks #67 on GitTiger, gaining +5 stars on November 4, 2026 (UTC).

The project is written in TypeScript and has 114 forks. It was created 22d ago.

AI-generated summary of the repository README — may contain errors.

What it is

open-wxa/wxa-runner is a TypeScript project under the MIT license. Its description (in Chinese) says it runs WeChat mini programs in an ordinary browser using the official WeChat base library, with Chrome DevTools debugging and Playwright E2E testing.

Capabilities described

Based on the README summary: - It runs the compiled mini-program output with the official base library, so rendering, components, setData and lifecycle behave like the real implementation rather than an H5 re-implementation. - Headless E2E testing with Playwright, without remote-controlling the developer tool. The README says this works in CI and, on Linux, needs no developer tool. - Debugging in Chrome DevTools (breakpoints, network, DOM) with hot reload on save. - Setup hooks to preset login state, mock native APIs and intercept requests without changing business code. - Opening any page directly via a URL such as `?path=pages/detail/detail&id=1`.

Topics also mention Taro, uni-app and WeChat.

Getting started

No install commands were supplied. Follow the repository README at https://github.com/open-wxa/wxa-runner.

Installation
git clone https://github.com/open-wxa/wxa-runner.git
cd wxa-runner
# see README for setup

Frequently Asked Questions

What problem does wxa-runner address?

It lets you run WeChat mini programs in a normal browser for local debugging and automated E2E testing, using the official base library.

Can it be used in CI?

The README summary says Playwright tests run headless in CI and that Linux does not need the developer tool.

How can I mock login or native APIs?

The README summary says setup hooks can preset login state, mock native APIs and intercept requests without changing business code. See the README for details.

What license is it under?

The supplied metadata lists the MIT license.