open-wxa/wxa-runner

これは何？

主な機能

• 01公式のWeChatベースライブラリを使い、コンパイル済みのミニプログラムをブラウザで実行します。
• 02ネイティブ、uni-app、Taroのビルド成果物に対応しています。
• 03WeChat DevToolsを使わずに、PlaywrightでヘッドレスのE2Eテストを実行できます。
• 04ブレークポイントの設定やネットワーク、DOMの確認など、Chrome DevToolsでのデバッグが可能です。
• 05保存時のホットリロードに対応しています。
• 06セットアップフックでネイティブAPIのモック、wx.requestのインターセプト、ログイン状態の事前設定ができます。

ユースケース

• Linux上のCIでミニプログラムのPlaywright E2Eテストを実行する。
• 開発中にブラウザのDevToolsを使ってページのロジックやネットワーク呼び出しをデバッグする。
• ログインのモックやバックエンドレスポンスのスタブが必要なフローをテストする。

クイックスタート

1. 1

   コンパイル済みのミニプログラムディレクトリで開発サーバーを起動します

   npx wxa-runner dev ./dist/dev/mp-weixin
2. 2

   ターミナルに表示されたローカルアドレスをブラウザーで開きます

使う前に知っておきたいこと

• !WeChat Developer Toolsの代わりにはなりません。プレビュー、アップロード、実機デバッグには引き続きWeChat Developer Toolsが必要です。
• !公式のWeChat base libraryを基盤としており、プロジェクトのMITライセンスの対象外です。

トピック

よくある質問

wxa-runner とは？

公式のWeChatベースライブラリを使ってWeChatミニプログラムを通常のブラウザで実行し、Chrome DevToolsでのデバッグやPlaywrightによるE2Eテストを可能にします。 wxa-runnerは、ネイティブプロジェクトやuni-app、Taroのビルド成果物を含む、コンパイル済みのWeChatミニプログラムをデスクトップブラウザで直接実行します。描画、コンポーネント、setData、ライフサイクルは再実装ではなく公式のWeChatベースライブラリ上で動作するため、アプリのH5版より実機に近い挙動になります。

wxa-runner は無料で使えますか？ライセンスは？

wxa-runner は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

wxa-runner は今もメンテナンスされていますか？

活発にメンテナンス中。wxa-runner の最終コミットは 2026年10月21日 です。

wxa-runner は何に使えますか？

Linux上のCIでミニプログラムのPlaywright E2Eテストを実行する。 開発中にブラウザのDevToolsを使ってページのロジックやネットワーク呼び出しをデバッグする。 ログインのモックやバックエンドレスポンスのスタブが必要なフローをテストする。

wxa-runner のインストール方法は？

コンパイル済みのミニプログラムディレクトリで開発サーバーを起動します: npx wxa-runner dev ./dist/dev/mp-weixin ターミナルに表示されたローカルアドレスをブラウザーで開きます

wxa-runner はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/open-wxa/wxa-runner