# wxa-runner > 在浏览器里用微信官方基础库运行微信小程序,用于本地调试和 E2E 自动化测试 wxa-runner 直接运行小程序的编译产物(原生小程序,或 uni-app、Taro 编译出的 mp-weixin 目录), 渲染、组件、生命周期都是微信官方基础库的代码。可以用 Chrome DevTools 调试,用 Playwright 写无头 E2E 测试, 在 setup 文件里预置登录态、mock 原生 API、拦截 wx.request。 - 启动:`npx wxa-runner dev <小程序目录>` - Playwright 测试:`@open-wxa/wxa-runner-playwright`,提供 `miniProgram` fixture - setup 文件的类型:`@open-wxa/wxa-runner-core/setup` - 源码:https://github.com/open-wxa/wxa-runner ## Table of Contents ### 开始 - [快速开始](https://open-wxa.github.io/wxa-runner/getting-started.md): 一行命令在浏览器里运行微信小程序:原生小程序、uni-app、Taro 编译产物的启动方式,以及怎么用 Chrome DevTools 打断点、看请求、看页面结构。 - [功能与限制](https://open-wxa.github.io/wxa-runner/features.md): wxa-runner 和微信开发者工具的区别,支持的项目类型、组件和 API,已验证的基础库版本,以及 Worker、蓝牙等已知限制。 - [wxa-runner 与 miniprogram-automator 对比](https://open-wxa.github.io/wxa-runner/vs-miniprogram-automator.md): 微信小程序自动化测试的两种方案:官方的 miniprogram-automator 控制开发者工具和真机,wxa-runner 在浏览器里用 Playwright 无头运行。运行环境、Linux / CI、真机、mock、插件的区别,怎么选,以及常用写法对照。 ### 开发调试 - [启动前准备(setup)](https://open-wxa.github.io/wxa-runner/setup.md): 用 wxa.setup.ts 在小程序启动前预置 Storage、mock wx.login 等原生 API、拦截 wx.request,跳过登录。从最小示例开始,按场景给出写法,并说明每个配置项。 - [借用开发者工具登录态](https://open-wxa.github.io/wxa-runner/devtools-login.md): 用 --devtools-login 借本机微信开发者工具的登录态访问微信后台:真实的 wx.login code 和手机号、服务市场 wx.serviceMarket、插件页面,新版开发者工具需要打开的安全设置,以及安全设置里找不到「允许获取工具登录票据」时怎么办。 - [热更新](https://open-wxa.github.io/wxa-runner/hot-reload.md): wxa-runner 的热更新:修改 WXSS、WXML 和页面、组件的 JS 后不刷新页面,data、页面栈和 globalData 尽量保留;其他改动整页刷新并恢复页面栈。 - [查看器:不带源码在浏览器里运行](https://open-wxa.github.io/wxa-runner/viewer.md): 用 wxa-runner viewer 把小程序打成 .wxapack 包,不带源码、不开开发服务器,在浏览器里运行;可以导出成静态站点部署,发链接给别人看。 ### 测试 - [:title | wxa-runner](https://open-wxa.github.io/wxa-runner/testing.md): 用 Playwright 给微信小程序写 E2E 测试:安装 @open-wxa/wxa-runner-playwright,打开页面、点击、断言页面 data,mock 原生 API、拦截和断言 wx.request。 - [uni-app 微信小程序 E2E 测试](https://open-wxa.github.io/wxa-runner/uni-app.md): 给 uni-app 项目写微信小程序 E2E 测试:用 Vite 插件在浏览器里运行 mp-weixin 编译产物,本地热更新调试,用 Playwright 无头测试,setup 跳过登录,CI 里先构建再测试。 - [在 CI 里跑微信小程序 E2E 测试](https://open-wxa.github.io/wxa-runner/ci.md): 不装微信开发者工具,在 GitHub Actions 的 Linux 机器上无头运行小程序 E2E 自动化测试:内置基础库和编译器,原生小程序和 uni-app 的完整配置,限制和排查方法。 - [测试 API](https://open-wxa.github.io/wxa-runner/test-api.md): 小程序页面上的 window.__wxa_test_api__:不用 Playwright fixture 时,直接用它读取页面 data、mock 原生 API、拦截和记录 wx.request、跳转页面。 ### 参考 - [命令与环境变量](https://open-wxa.github.io/wxa-runner/cli.md): wxa-runner 命令行:dev 启动开发服务器的选项(端口、局域网访问、基础库版本、setup、报错转发到终端、借用开发者工具登录态)和配置文件 wxa.config.ts,baselib 管理基础库,viewer 打包和部署查看器,以及 WXA_BASELIB 等环境变量。 - [常见问题](https://open-wxa.github.io/wxa-runner/faq.md): wxa-runner 常见问题:能不能替代微信开发者工具,和 miniprogram-automator 的区别,CI 里不装开发者工具怎么跑小程序 E2E 测试,uni-app、Taro 支持,跳过登录、mock wx.request,基础库版本。 ### Other - [真实登录(已改名)](https://open-wxa.github.io/wxa-runner/real-login.md): 「真实登录」(--real-login)已改名为「借用开发者工具登录态」(--devtools-login)。