【开源自荐】wxa-runner：在浏览器里用微信官方基础库运行小程序，支持 Playwright 无头测试
まだ誰も着手していません。
評価
- 難易度
- 1/5
- 見積もり時間
- 1時間未満
- 初心者へのやさしさ
- 15/100
- issue の種類
- ドキュメント
- 明瞭さ
- 説明が足りない
- 活発さ
- 活発
- 技術スタック
- javascript, playwright, typescript
- 領域
- content
調査の方向性
This is a project recommendation, not a request for a change, and the payload names no files or tests in the weekly repository. Read the issue and the linked wxa-runner project description to understand the submission; there is no completion criterion for a code contribution stated here.
索引モデルが issue の本文から書いたものです。
説明
项目地址：https://github.com/open-wxa/wxa-runner
我是项目作者。wxa-runner 是一个开源（MIT）命令行工具，可以在普通浏览器里运行微信小程序，用于本地调试和 E2E 自动化测试。
它不把小程序转成 H5，而是直接加载微信官方的基础库和编译器，自己只实现微信客户端的「原生层」：消息桥、页面栈、原生 API，以及导航栏、tabBar、弹窗这些原生界面。渲染、组件、setData、生命周期都由官方代码完成，行为和开发者工具一致。
在小程序目录（或 uni-app / Taro 编译出的 mp-weixin 目录）里一行启动：
npx wxa-runner dev . --open
能做什么
- AI Agent 可以直接操作：Claude Code、Codex 这类 Agent 最擅长的就是操作浏览器。小程序跑在浏览器里，它们用现成的浏览器能力就能点页面、看 DOM、读控制台和网络请求、写 Playwright 测试，不用为小程序额外配置开发者工具的自动化端口
- 用 Chrome DevTools 调试：打断点、看网络请求和 DOM，调用栈停在业务代码上，不会掉进基础库
- Playwright 无头测试：直接在浏览器里跑 E2E，不用远程控制开发者工具，CI 里没装开发者工具也能跑
- 跳过登录：在
wxa.setup.ts里预置 storage、mock 原生 API、拦截wx.request，不用改业务代码 - 直接打开任意页面：地址加上
?path=pages/detail/detail&id=1即可 - 热更新：改页面的 wxml、js、wxss 不刷新页面，页面栈和全局状态都保留
测试写起来是这样：
test('提交后跳转到结果页', async ({ miniProgram }) => {
await miniProgram.mock('login', { code: 'test_code' });
await miniProgram.open('pages/form/form');
await miniProgram.current.locator('#submit').click();
await expect(miniProgram).toHavePath('pages/result/result');
await expect(miniProgram).toHavePageData({ status: 'ok' });
});
当前边界
- 不替代开发者工具：预览、上传、真机调试仍然要用开发者工具
- 不支持蓝牙等设备能力，也不支持插件、分包异步化和 Worker
- 已在 uni-app（Vue 3）真实项目上验证，基础库验证过 2.32.3 到 3.8.8 之间的多个版本
欢迎试用。遇到跑不起来的小程序，请到 Issue 里反馈。
- 主要言語
- 言語のデータがありません
- スター
- 1.9k
- フォーク
- 72
- PR マージ指標
- 30日以内にマージされた PR はありません
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
OpenGithubs/weekly のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
OpenGithubs/weekly#157 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
OpenGithubs/weekly#106 ·
-
難易度 1/5 1時間未満 初心者へのやさしさ 25/100
OpenGithubs/weekly#177 ·
-
難易度 1/5 1時間未満 初心者へのやさしさ 15/100
OpenGithubs/weekly#175 ·
-
難易度 1/5 1時間未満 初心者へのやさしさ 38/100
OpenGithubs/weekly#173 ·
OpenGithubs/weekly の issue をすべて見る
似ている issue
-
咸鱼小窝オープン待处理 申请收录
難易度 1/5 1時間未満 初心者へのやさしさ 65/100
travellings-link/travellings#4053 ·
-
good first issue
難易度 2/5 1〜3時間 初心者へのやさしさ 60/100
Boston-area-Women-in-Bioinformatics/webpage#429 ·
メンテナーはふだん 2 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
-
難易度 1/5 1時間未満 初心者へのやさしさ 80/100
521xueweihan/HelloGitHub#4063 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100