Vue 测试最佳实践
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/vuejs-ai-skills-vue-testing-best-practices。
技能介绍
你可能卡在哪些测试问题上
Vue 3 项目一上 CI,常见现象是:改了一点组件内部实现,单元测试全红;或者 flushPromises 没等够,间歇性失败;Composable 里用了 onMounted / inject,单测里直接跑不起来;Pinia 报 injection Symbol(pinia) not found;带 async setup 的组件在 mount 后一直是空树;快照全绿但线上功能坏了;Teleport 出去的弹层用 wrapper.find 永远找不到;defineAsyncComponent 包一层就测不通。这些往往不是「不会写断言」,而是测试策略和运行环境没对齐 Vue 3 的真实行为。
技能覆盖什么、怎么帮你做决策
本技能按场景索引组织,把问题映射到具体实践条目,例如:
- 基建选型:Vue 3 单测优先走 Vitest 相关建议(参见
testing-vitest-recommended-for-vue) - 组件测试:倾向黑盒测对外契约,减少绑死内部结构(
testing-component-blackbox-approach) - 异步:用
async/await与flushPromises处理竞态(testing-async-await-flushpromises) - Composable:用 helper / wrapper 处理生命周期与
inject(testing-composables-helper-wrapper) - Pinia:在测试里正确挂载 store(
testing-pinia-store-setup) - Suspense / 异步组件:让带
async setup的组件能在测试中渲染(testing-suspense-async-components、async-component-testing) - 反模式:避免仅靠快照掩盖行为回归(
testing-no-snapshot-only) - E2E:Vue 应用 E2E 框架选型(如 Playwright 相关建议,
testing-e2e-playwright-recommended) - 运行环境:要验
computed style或真实 DOM 事件时,区分 browser vs node runner(testing-browser-vs-node-runners) - Teleport:理解查询范围与挂载点(
teleport-testing-complexity)
文末 Reference 指向 Vue 官方 Testing Guide、Vue Test Utils、Vitest、Playwright 文档,便于你核对 API 与配置细节。
适用边界
这是测试实践与排错索引,不是替你做项目脚手架一键生成;具体配置仍以你仓库的构建工具、测试 runner 版本为准。E2E 与单测分工、CI 并行度等团队规范需你自己落地。若问题不在上述条目(例如纯视觉回归、跨框架微前端),应结合其它专项技能或官方文档扩展。
使用场景
- 新 Vue 3 仓库要定 Vitest 与 Vue Test Utils 的测试基建,并避免和 Vite 配置冲突
- 组件重构后单测频繁失败,需要把断言从内部实现改为对外行为与 props/emit 契约
- CI 里 composable 或 Pinia 相关用例报 inject/pinia 错误,需要在测试里正确挂载依赖
- 选型 E2E 时要覆盖 Teleport 弹层、async setup 页面,并判断何时必须用 browser runner
适合人员
- 维护 Vue 3 组件库、每次发版都要跑单测并担心重构把测试绑死在实现上的前端工程师
- 负责前端 CI 流水线、要排查间歇性失败与 async/Pinia 环境问题的全栈或平台工程师
- 从 Vue 2 迁移到 Vue 3、需要重写测试策略并评估 Playwright E2E 的技术负责人
- 写大量 Composable 的业务前端,需要在不启动整页应用的情况下单测生命周期与 inject