wxa-runner README

项目的 README,来自 github.com/open-wxa/wxa-runner。合并为一个 markdown 文件:README.md。

wxa-runner

2026 年 11 月,本项目应腾讯公司要求下线,代码、文档和 npm 包均已停止提供。

它曾经是什么

在普通浏览器里,用微信官方基础库运行小程序,用于本地调试和 E2E 自动化测试:

它是给开发者测试自己的小程序用的,仅此而已。

事实证明,在浏览器里调试自己写的代码,也是需要被批准的。

如果你也想给小程序写 E2E 测试

  1. 找一台 Windows 或 macOS 机器
  2. 安装微信开发者工具,并保持登录
  3. 打开自动化端口,祈祷它别弹窗
  4. 祝你好运

最后

感谢所有用过它、提过 Issue 和 PR 的朋友。一千多个 star 说明,这件事确实有人需要。

也感谢腾讯专程来打招呼,让一个调试工具有了它本不配拥有的关注度。

祝小程序生态“越来越好”,祝开发者工具“越来越稳定”。

wxa-runner (open-wxa/wxa-runner)

正在搜索数据库…

这是什么?它使用官方 WeChat 基础库,在普通浏览器中运行 WeChat 小程序,用于本地调试和 Playwright 端到端(E2E)测试。
它是应用、库,还是别的什么?它是一个开发者工具。它直接用官方基础库运行你编译后的小程序产物,而不是把基础库重新实现为 H5,因此渲染、组件和生命周期的表现与真机一致。
我该怎么把它跑起来?按文档中的快速开始安装该包、WeChat 基础库和编译器;具体命令不在 README 摘录中。然后在浏览器中打开页面,并使用 ?path= 参数直接跳转到目标页面。
开始前我需要准备什么?需要一个可以运行的小程序项目(编译后的 uni-app 或 Taro 产物);如果要写 E2E 测试,还需要 Playwright。README 未列出版本要求。
它能替代 WeChat 开发者工具吗?不能。预览、上传和真机调试仍需要官方 WeChat 开发者工具。
我能不装 WeChat 开发者工具,直接在 CI 中跑测试吗?可以。在 CI 中它以无头模式(headless)在 Linux 上运行,无需在那里安装 WeChat 开发者工具。
不装任何东西也能试用吗?可以。在线预览会在浏览器中运行一个 uni-app 小程序,并使用模拟数据;投票、评论和发帖都可以使用,刷新后会重置。
保存时会热重载吗?会。你可以在 Chrome DevTools 中设置断点、查看网络请求和 DOM,保存后修改会热更新。
测试时能跳过登录并模拟原生 API 吗?可以。在 setup 中可以预设登录状态、模拟原生 API 并拦截 wx.request,无需修改业务代码。
能不分享源码,只分享运行结果吗?可以。查看器可以在浏览器中运行没有源码的小程序,还可以将其导出为静态站点发送给他人。
作者
open-wxa
大小
0 MB
星标
1.3K
更新
提交Nov 16
时长
1个月
提交 · 90 天