1.3K ·GitHub
这是什么?
它使用官方 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,无需修改业务代码。
能不分享源码,只分享运行结果吗?
可以。查看器可以在浏览器中运行没有源码的小程序,还可以将其导出为静态站点发送给他人。
有哪些类似的项目?
moli, veding-ui, agentic-playwright, reticle, WxJava, vant-weapp, esp32sim, testsprite-cli
它属于哪些主题?
chrome-devtools, miniprogram, simulator, e2e-testing, headless, wechat, debugging, playwright, testing, nodejs, typescript, web