open-wxa / wxa-runner

# wxa-runner
> 在普通浏览器里，用**微信官方基础库**运行小程序。为本地调试和 E2E 自动化测试而生。
**文档** · English · 中文
 [code] 
- **和真机一致**：直接运行小程序的编译产物，渲染、组件、`setData`、生命周期都是微信官方基础库的代码，不是 H5 那样由框架重新实现
- **无头 E2E**：用 Playwright 直接在浏览器里测试，不用远程控制开发者工具；CI 里无头运行，Linux 上不需要开发者工具
- **用熟悉的工具调试**：Chrome DevTools 打断点、看网络请求、看 DOM，保存后热更新
- **跳过走不通的环节**：在 setup 里预置登录态、mock 原生 API、拦截请求，不用改业务代码
它不替代开发者工具：预览、上传、真机调试仍然要用开发者工具。
## 文档
- 快速开始：安装、基础库和编译器
- 启动前准备（setup）：跳过登录、mock 原生 API、拦截 `wx.request`
- 真实登录：借开发者工具的登录态拿真实的 code 和手机号
- 热更新
- 在 Playwright 中测试
- 命令与环境变量
- 功能与限制
## 参与开发
从源码构建、运行示例和测试见 CONTRIBUTING.md。欢迎提交 Issue 和 PR。
## 致谢
- 微信团队：官方基础库与编译器
- WEPT：最早验证了在浏览器中运行小程序的可行性
## 许可证
MIT。内置基础库 wxa-baselib 是微信官方代码，版权归腾讯所有，不适用本项目的 MIT 协议。