wxa-runner

wxa-runner 是一款小程序本地运行与E2E自动化测试工具，可以在普通浏览器中，依托微信官方小程序基础库直接运行小程序编译产物，适配原生小程序、uni-app、Taro编译出来的微信端包。

启动命令示例：

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

启动后访问 [http://localhost:3000](http://localhost:3000) 即可预览。

核心特点

1. 使用微信官方基础库

直接加载小程序编译产物，渲染逻辑、内置组件、setData、页面生命周期全部是微信原生基础库实现，不是H5模拟重写，行为更贴近真机表现。

2. 无头E2E自动化测试

基于Playwright，直接在浏览器内执行测试，不需要远程操控微信开发者工具。支持CI流水线无头运行，Linux环境也可以跑，摆脱开发者工具依赖。

3. 浏览器原生调试体验

直接使用Chrome DevTools断点调试、查看网络请求、DOM结构；文件保存支持热更新，调试方式对前端开发者更熟悉。

4. 预置环境与Mock能力

可在setup阶段预先注入登录态、mock小程序原生API、拦截网络请求，无需修改业务源码，快速构造各种测试场景。

边界说明

wxa-runner不能替代微信开发者工具。小程序的上传、预览、真机调试等正式发布流程，依旧需要使用官方开发者工具完成。