前言
前端测试一直存在庞大的需求,但具体讨论如何在实战中构建合理测试体系的文章却不多。随着社区工具的成熟和不断尝试,我摸索出一套可用于实战的方法,为团队搭建测试基础设施。
如何进行技术选型
选择某项解决方案之前,必须知道自己选择的原因以及未来的发展方向,尤其是在 Web 领域,已经被淘汰的技术和遗留代码太多了
前端环境的复杂程度毋庸置疑,不同的浏览器、版本、设备尺寸、开发环境⋯⋯就连工具链也经历过多次迭代,比如: Gulp > Webpack > Vite。选择比努力更重要,要把精力投入正确的方向,根据社区反馈和统计数据做判断。
- JavaScript 调查
- 保持对前端生态的敏锐度,关注社区中主要的意见领袖和讨论(YouTube、Hacker News、daily.dev)
- 了解并评估不同解决方案之间的取舍
- 查阅官方文档(Vue 测试、React 测试)
虽然在 Web 开发领域没有技术是一成不变的,但根据问卷调查和社区趋势来看,大量成熟的元框架和生态工具(Nuxt、SvelteKit、SolidStart、Astro、Vitest、Storybook)都建立在 Vite 之上。在 2026 年开发 Web 应用,几乎一定会接触到或基于 Vite 生态。恰好我的工作和日常项目也都基于 Vite,因此会明显偏向这个生态,相关理念也会影响后续决策。但如果你身处 Angular、Next 这样自成体系的生态中,那就是另一回事了。
根据以上评估,目前我的技术栈如下:
测试之前
研究如何编写有效且有意义的测试
- 明确产品的性质、测试的侧重点(toC 侧重视觉 / toB 侧重功能?)
- 了解测试的种类与术语(你需要知道的软件测试类型和常识)
- 了解测试的通用原则(如何保持测试的健壮性、了解不稳定测试的成因以及如何避免)
- 如何确保团队能稳步引入测试流程(准备测试入门文档
HowToTesting.md) - 测试如何持续提供反馈?(在 CI 中?在 Git Hooks 中?)
- 规划如何以最小的成本获得最大的收益?(如何引入 AI 降低测试成本?)
需要考虑的事情很多,所以我会从一个最基础、最实际的假设问题开始,暂时不考虑遗留代码的问题:「假如我是刚加入这个项目的成员,编写一个新功能时要如何添加测试?」、「测试如何为团队带来收益?」。这时,缺少什么环境、缺少哪些文档、流程有何缺陷或哪些环节不具备成本效益,都会显现出来,再一步步思考如何解决。
搭建测试环境
进行前端测试需要掌握一些特殊的前置知识:
- JavaScript 有两种运行环境:Nodejs 和浏览器。
- 可以用 JSDOM 或 HappyDOM 在 Node.js 中模拟浏览器环境,速度会慢一些,而且可能存在模拟不完整的问题,好处是不需要配置真实的浏览器环境。
- 传统 E2E 测试方案会启动真实的无头浏览器,以「页面」为单位进行模拟测试,但随着工具的进步,渲染特定前端框架的组件来进行测试也变得可行:Vitest Browser Mode、Cypress 组件测试、Playwright 组件测试。
我选择 Vitest Browser Mode 的原因是:
- 它是主流的开源测试工具。
- 可以用相同的工具和 API 测试不同类型的前端代码。通过同一个测试运行器创建不同的环境(Projects),接入不同的 Vite 环境和浏览器引擎。例如,我会设置不同的文件名来对应测试环境:
Foo.browser.test.ts、Foo.jsdom.test.ts、Foo.node.test.ts。 - 我喜欢 Cypress 的集成体验和完善的文档,但从高级功能收费到其架构特有的 API,它仍让我觉得是一项封闭的技术:Cypress 与 Playwright 如何选择?
- Playwright 可以作为 Browser Mode 的引擎,支持所有浏览器,而且有非常直观的 CI 配置体验。
启动测试的步骤
- 创建一个
HowToTesting.md文档,把踩过的坑、流程、能提升测试质量的案例都记录下来,避免 AI 和接手的人犯同样的错误。- 使用 Gerkin 语句结构编写测试用例,提升测试的可读性。
- 常见自定义组件的真实测试示例。
- ⋯⋯
- 选一个速度够快、成本够低的 Coding Agent,测试需要大量试错和迭代,目前我觉得 Grok Fast 1 的体验非常好。
- 开始用自然语言写测试:
// 提前规划测试用例describe('Foobar.vue', () => { test.todo('测试用例 A', () => {}) test.todo('测试用例 B', () => {}) test.todo('测试用例 C', () => {})
// 也可以先跳过其他用例,逐项解决,避免上下文过大 test.only('测试用例 C', () => {})})根据 @Foobar.vue 完成 @Foobar.browser.test.ts ,请参考 @HowToTesting.md总结
测试的瓶颈不在于「熟悉特定框架」或「生态还不够成熟」。在实战中,90% 的测试代码已经不需要手动编写,可以将测试的重心更合理地分配到:
- 明确合理的测试边界与测试方式
- 审核把关测试质量
- 通过测试思考更合理的软件架构
其他反思
如何看待在 Storybook 中写测试
为什么我不喜欢 Storybook - Theo Throwaways
经过多年的整合,现在可以直接在其中编写测试用例。但我仍持观望态度,暂不采用:
- 又要通过插件把测试套进它们的格式,让我有些不安,会不会哪天想迁移却迁不走?
- 它们大力推广自家的平台和相关视觉测试服务,让我产生了与 Cypress 一样的预感。
- Storybook 又带来了额外且复杂的学习成本和需要维护的项目,对小团队用处不大。
所以我只投入最少的精力维护,让 AI 为组件生成一些粗略的 Story 记录,作为活文档。
延伸阅读
- 現代 bundler、build tool 簡介 - Code Farmer
- JSDC 2020 - 用 API mocking 讓前端不再苦苦等待 | Huli
- Why I Won’t Use JSDOM