Vitest 3.0 发布：现代化测试框架的重大升级

Vitest 作为一款现代化的前端测试框架，近日正式发布了 3.0 版本。这个版本带来了多项重要改进和新特性，同时也包含了一些必要的破坏性变更。作为 Vite 生态中的原生测试解决方案，Vitest 3.0 进一步巩固了其在开发者社区中的地位，提供了更强大、更灵活的测试能力。

核心特性与改进

1. 测试上下文增强

新版本显著改进了测试上下文的处理方式。现在测试钩子函数能够接收完整的上下文信息，这为测试逻辑提供了更大的灵活性。开发者可以通过上下文注入配置中定义的provide值，使得测试环境配置更加动态化。

2. 强大的新匹配器

Vitest 3.0 引入了多个实用的新匹配器，极大丰富了断言能力：

• toHaveBeenCalledExactlyOnceWith：精确验证函数是否被调用一次且参数匹配
• toHaveBeenCalledAfter/toHaveBeenCalledBefore：验证函数调用顺序
• toSatisfy：自定义验证逻辑的异步匹配器
• toBeOneOf：验证值是否在指定集合中

3. 快照测试增强

快照测试功能得到了多项改进：

• 支持在resolveSnapshotPath中访问配置信息
• 修复了重试和重复测试场景下的快照状态问题
• 改进了toMatchFileSnapshot的白空格处理

4. 浏览器测试能力提升

浏览器测试支持获得了显著增强：

• 新增多浏览器配置支持
• 实现了剪贴板API的测试能力
• 改进了元素查询API，新增nth()方法
• 优化了源映射处理，特别是在使用vi.mock时

破坏性变更

作为大版本更新，Vitest 3.0 包含了一些必要的破坏性变更：

1. spy.mockReset的行为发生了变化，开发者需要检查相关测试用例
2. 测试钩子现在会接收完整的上下文对象
3. 快照状态会在重试和重复测试时重置
4. 覆盖率报告默认排除测试文件
5. 错误比较现在会检查更多属性

性能与稳定性

3.0 版本在性能和稳定性方面做了大量优化：

• 改进了长时间同步任务的超时处理
• 优化了控制台日志的批处理机制
• 修复了多种内存泄漏问题
• 提升了大型对象差异比较的稳定性

开发者体验

Vitest 3.0 特别关注开发者体验的提升：

1. UI 改进：

   • 支持从UI界面直接运行单个测试或测试套件
   • 增强了模块图的可视化能力
   • 改进了测试结果导航体验

2. 配置简化：

   • 支持内联工作区配置
   • 项目名称现在会作为标签显示
   • 改进了项目继承机制

3. 报告增强：

   • 引入了全新的报告API
   • 改进了默认和详细报告器的摘要显示
   • 增加了重试和重复次数的显示

生态系统兼容性

Vitest 3.0 保持了对现代前端生态系统的良好支持：

• 全面支持 Vite 6
• 兼容 Node.js 21
• 支持 React 19
• 改进了 TypeScript 类型检查的稳定性

升级建议

对于现有项目，建议参考官方迁移指南进行升级。虽然包含破坏性变更，但 Vitest 团队确保了迁移路径尽可能平滑。新项目可以直接采用 3.0 版本，享受所有最新特性和改进。

Vitest 3.0 的发布标志着这个年轻而充满活力的测试框架进入了成熟阶段，为前端开发者提供了更强大、更可靠的测试工具链。无论是单元测试、组件测试还是端到端测试，Vitest 3.0 都能提供出色的开发体验和测试能力。