Vitest 3.0版本中toThrowError断言的行为变更解析

在JavaScript测试框架Vitest从2.1.8升级到3.0.4版本后，开发者可能会遇到一个关于错误类型断言的变化。这个变化虽然看似微小，但对于测试用例的编写有着重要影响。

错误类型断言的变化

在Vitest 2.1.8版本中，以下测试用例能够正常通过：

test('无效URL格式', () => {
  expect(() => new URL('hha')).toThrowError(new Error('Invalid URL'));
});

然而在3.0.4版本中，同样的测试会失败。这是因为new URL()实际上抛出的是TypeError而非普通的Error。新版本中Vitest对错误类型的检查变得更加严格，不仅比较错误信息，还会比较错误类型本身。

新版解决方案

针对这种情况，开发者有以下几种处理方式：

1. 精确匹配错误类型：

expect(() => new URL('hha')).toThrowError(new TypeError('Invalid URL'));

2. 仅匹配错误信息（推荐）：

expect(() => new URL('hha')).toThrowError('Invalid URL');

3. 使用正则表达式匹配：

expect(() => new URL('hha')).toThrowError(/Invalid URL/);

为什么这样设计

这种变更体现了测试最佳实践的发展趋势：

1. 更精确的错误验证：不同类型的错误代表不同的程序状态，精确匹配可以确保测试覆盖所有边界情况。

2. 减少误判：相同错误信息可能来自不同错误类型，严格检查可以避免假阳性结果。

3. 与TypeScript类型系统更好配合：明确的错误类型检查可以与类型系统形成互补。

迁移建议

对于从旧版本迁移的项目：

1. 首先将所有toThrowError(new Error(...))改为只检查字符串形式
2. 对于确实需要验证特定错误类型的场景，使用具体的错误类
3. 考虑使用.toThrowErrorMatchingSnapshot()简化复杂错误验证

这种变化虽然需要一些迁移工作，但长期来看会使测试更加健壮和可靠。