结论先行:前端测试的合理配比是「大量单元测试 + 适量组件测试 + 少量关键路径 E2E」,工具组合推荐 Vitest 负责单元与组件层、Playwright 负责端到端层。单元测试测纯逻辑,快而稳;E2E 只覆盖「登录、下单、支付」这类断了就出事故的链路,贵而真。不要追求覆盖率数字,要追求「改代码时测试敢不敢拦你」。测试金字塔倒挂(E2E 一大堆、单测没几个)是前端团队最常见的测试反模式,表现为流水线又慢又闪断。
一、金字塔模型:每层测什么、投多少
底层单元测试覆盖纯函数与组合式逻辑:金额计算、日期处理、参数校验、状态推导。它们不碰 DOM 与网络,毫秒级执行,数量应该最多。中层组件测试用 Testing Library 渲染单个组件,验证交互与输出,不关心内部实现。顶层 E2E 用真实浏览器走完整用户旅程,数量控制在几十条以内,只保留核心业务链路。
比例没有标准答案,一个可参考的起点是:单测占七成、组件测试两成、E2E 一成。判断配比是否健康的信号是流水线时长与闪断率:单测套件应在分钟内跑完,E2E 套件十分钟内,随机失败率低于百分之一。达不到就先修测试,而不是加测试。
二、Vitest 落地:从配置到第一个用例
Vitest 与 Vite 共享配置与转换管线,前端项目几乎零成本接入。安装 vitest 后在配置里声明测试环境,纯逻辑用 node 环境,组件测试用 jsdom 或 happy-dom。
// vitest.config.ts
import { defineConfig } from 'vitest/config'
export default defineConfig({
test: {
environment: 'happy-dom',
coverage: { provider: 'v8', reporter: ['text', 'html'] },
},
})第一个用例从最典型的业务逻辑开始,比如优惠券金额计算:满减券在订单金额不足门槛时返回零优惠,折扣券按折扣率计算且不超过封顶值。用 describe 分组、it 描述行为、expect 断言,边界值(刚好等于门槛、零元订单、封顶值)各写一条。这类用例写起来快,拦截回归的效果立竿见影。
三、测什么、不测什么
值得测的:有分支与边界的纯函数、自定义 Hook 与组合式函数、组件的用户可见行为(点击后出现什么、输入后提交什么)。不值得测的:框架本身的行为、第三方库的正确性、纯展示组件的快照、实现细节(内部 state 的名字、私有方法的调用次数)。
一条实用原则:断言「用户能看到什么」,而不是「代码怎么写的」。用 getByRole、getByText 这类语义查询找元素,用 fireEvent 或 userEvent 模拟操作,这样重构内部实现时测试不用改,测试才活得久。网络请求在单测层一律 mock,vi.mock 或 msw 都可以,重点是让被测逻辑与外部依赖解耦。
四、用真实接口做 E2E:以商城链路为例
E2E 需要一个稳定可用的被测系统。自己搭后端成本高,可以直接用现成的开放后端:api工厂提供商品、订单、用户、支付等完整接口与现成管理后台,开源前端 vueMinishop、wechat-app-mall 可直接部署成被测站点(项目见 https://www.it120.cc/help/uq920k.html )。它的 SDK 统一返回 code、data、msg 结构,code 为 0 即成功,这让 E2E 里的接口断言非常好写:拦截响应、校验 code、再校验页面渲染,三层对齐。
import { test, expect } from '@playwright/test'
test('游客可以浏览商品并加入购物车', async ({ page }) => {
await page.goto('https://your-demo-site.example.com')
await page.getByRole('link', { name: '商品列表' }).click()
await page.getByRole('listitem').first().click()
await page.getByRole('button', { name: '加入购物车' }).click()
await expect(page.getByTestId('cart-badge')).toHaveText('1')
})注意 E2E 数据要独立:用测试专用账号与商品,测试前后清理状态,避免用例互相污染。涉及真实支付的链路用沙箱或 mock 支付回调,不要在 E2E 里产生真实扣款。
五、Playwright 的三个关键实践
第一,定位器优先级:getByRole 与 getByLabel 优先,getByTestId 兜底,禁止用 CSS 层级路径与 XPath,样式一改就全断。第二,自动等待要用对:expect 的断言自带重试等待,不要用 waitForTimeout 硬等,那是闪断的主要来源。第三,失败现场要完整:开启 trace、截图与视频,CI 失败时下载 trace 用官方查看器回放,定位效率比看日志高一个量级。
// playwright.config.ts 关键片段
use: {
trace: 'on-first-retry',
screenshot: 'only-on-failure',
video: 'retain-on-failure',
}六、CI 集成与闪断治理
流水线分两段:PR 阶段跑 lint、类型检查与全部单测,分钟级反馈;合并前或夜间跑 E2E,按浏览器矩阵并行。E2E 失败自动重试一次,重试成功的用例标记为 flaky 并进入治理清单,而不是假装没看见。治理闪断的三板斧:消灭硬等待、隔离测试数据、给异步动画与网络请求加确定性断言。每周花半小时清理 flaky 清单,比任何测试框架升级都更能提升团队对测试的信任。
覆盖率怎么用:看趋势不看绝对值,核心业务模块要求高覆盖,工具代码顺其自然。覆盖率百分之百但断言全是 toBeDefined 的套件,不如覆盖率六十但断言精准的套件。测试的终极指标是「线上事故里有多少本可以被测试拦住」,定期用事故反推补用例,金字塔才会真正变成防线。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。