@dcloudio/uni-automator 是最贴近 uni-app 实际运行环境的单元测试方案,需基于编译后的小程序目录启动真实运行时,支持完整 uni API 和生命周期,但不暴露 Vue 实例,断言应聚焦可观察行为。

@dcloudio/uni-automator 是目前最贴近 uni-app 实际运行环境的单元测试方案,但直接上手容易卡在「组件不渲染」「uni API 报 undefined」或「page 实例拿不到」这几个点上。它不是 Vue Test Utils 那种纯 DOM 模拟,而是启动一个轻量小程序运行时,所以必须走真实编译流程。
为什么不能直接用 Vue Test Utils + Jest
Vue Test Utils 会把 .vue 文件当普通 Vue 组件加载,但 uni-app 的页面和组件依赖 uni 全局对象、getCurrentPages()、生命周期钩子注入机制,以及平台特定的编译产物(如微信小程序的 Page 构造函数)。Jest 环境里这些全不存在,硬 mock 容易漏掉关键行为,比如 onLoad 参数解析、onShow 触发时机、uni.navigateTo 调用后的页面栈变化。
- 你 mock 了
uni.navigateTo,但没 mockprogram.pageStack(),后续断言页面路径就失效 -
onLoad({ id: '123' })在 Jest 里不会自动触发data.id初始化,得手动调用或靠mount选项传参 - 微信 API(如
uni.login、uni.getSystemInfo)在 Jest 中默认抛错,需逐个 patch,维护成本高
@dcloudio/uni-automator 必须走「编译后测试」
它要求你先用 HBuilderX 或 CLI 将项目构建为小程序目录(如 unpackage/dist/dev/mp-weixin),再让 automator 加载该目录启动模拟运行时。这意味着:
- 测试前必须执行
npm run dev:mp-weixin或点击 HBuilderX 的「运行到小程序模拟器」 - 测试脚本里写的
await program.navigateTo('/pages/index/index'),实际跳转的是编译后路径,不是源码路径 - 所有
uni.方法、getApp()、getCurrentPages()都是真实可用的,无需 mock - 但你也无法直接 import 源码中的工具函数或 service —— 它们不在小程序运行时上下文中,得通过
program.evaluate注入或提前打包进uni_modules
真机调试时 program API 的坑
automator 的 program 对象在模拟器下工作良好,但连接真机(尤其是 iOS)时,部分方法会超时或返回空:
-
program.currentPage()在某些 iOS 真机上返回undefined,建议改用program.pageStack().then(pages => pages[pages.length - 1]) -
program.systemInfo()可能延迟 >2s,加timeout选项:await program.systemInfo({ timeout: 5000 }) -
program.reLaunch('/pages/login/login')后立即调program.currentPage(),大概率拿到旧页面,需加await sleep(300)或监听page.onLoad事件 - 真机网络请求无法被 automator 的
program.network拦截(仅模拟器支持),抓包得用 Charles / Proxyman 配合手机代理
测试断言要聚焦「可观察行为」
别写 expect(wrapper.vm.data.text).toBe('hello') 这类内部状态断言 —— automator 不暴露 Vue 实例。你应该验证:
- 页面是否成功跳转:
expect((await program.currentPage()).path).toBe('pages/detail/detail') - 元素文本是否正确:
expect(await page.$text('.title')).toBe('订单详情') - API 调用是否发出且参数正确:用
program.network.listen监听/api/order请求体 - 用户交互是否触发预期效果:点击按钮 → 断言 toast 显示 / URL 参数变更 / storage 写入
真正难测的从来不是逻辑,而是跨端生命周期与平台 API 的耦合。比如 onHide 在小程序后台时触发,在 H5 却不触发;uni.getProvider 在支付宝小程序返回空数组,微信则返回 ['oauth']。这些边界,光靠单元测试覆盖不了,得靠真机回归+自动化截图比对。











