想在浏览器里直接运行微信小程序,而不是把它转成 H5?wxa-runner 做到了——它在浏览器中使用微信官方基础库来渲染小程序,让 setData、组件生命周期等行为与真机保持一致。

功能特性
它让你在普通浏览器里用真机同款基础库运行小程序,配合 Chrome 调试和 Playwright 做自动化测试,不再绑定微信开发者工具。
- 渲染逻辑走官方基础库,setData、组件生命周期这些和真机表现一致,不是模拟器自己实现
- Chrome DevTools 直接打断点、看网络、审查 DOM,保存代码自动热更新
- Playwright 无头跑 E2E 测试,CI 流水线里 Linux 服务器直接跑,不用装开发者工具
- 启动前能预置登录态、mock wx.xxx 原生接口、拦截请求,业务代码不用改
- 支持借用开发者工具拿真实 code、手机号,也能跑插件页面
怎么用
npx wxa-runner dev ./dist/dev/mp-weixin
# 默认起在 http://localhost:3000
目录可以是原生小程序,也可以是 uni-app、Taro 这些框架的编译输出。预览上传和真机调试还得用微信开发者工具,这个替代不了。
用它做什么
- 用 Playwright 写微信小程序的 E2E 测试:打开页面、点击、断言页面 data 和发出的请求
- 在 CI 里跑小程序自动化测试:GitHub Actions 的 Linux 机器上无头运行,不装开发者工具
- 给 uni-app 项目写 E2E 测试:运行 mp-weixin 编译产物,源码改动后热更新
- 跳过登录、mock 原生 API 和 wx.request:不用改业务代码
- 和 miniprogram-automator 怎么选:两种小程序自动化测试方案的区别
声明:本站原创文章文字版权归本站所有,转载务必注明作者和出处;本站转载文章仅仅代表原作者观点,不代表本站立场,图文版权归原作者所有。如有侵权,请联系我们删除。