Deno标准库中错误断言功能的深度解析

在Deno标准库的测试工具中，assertThrows和assertRejects是两个常用的错误断言函数。它们主要用于验证代码是否按预期抛出错误，但当前功能存在一些局限性，特别是在错误对象属性验证方面。

现有功能分析

目前这两个断言函数主要通过message属性来验证错误对象：

• assertThrows用于同步代码的错误断言
• assertRejects用于异步Promise的错误断言

它们的基本用法是验证：

1. 是否抛出了特定类型的错误
2. 错误消息是否符合预期（通过字符串或正则表达式匹配）

功能局限性

在实际开发中，开发者经常需要验证错误对象的其他属性，例如：

1. 标准化的DOMException通常具有重要的name属性
2. 自定义错误类可能包含业务相关的属性（如错误代码）

现有API无法直接验证这些非message属性，开发者需要额外的断言代码，这降低了测试代码的可读性和简洁性。

改进方案探讨

社区提出了两种可能的增强方案：

回调函数方案

允许传入一个验证函数，对捕获的错误对象进行全面检查：

assertRejects(
  () => promiseFunction(),
  DOMException,
  (err) => err.name === 'TimeoutError'
)

属性对象方案

通过属性对象直接匹配错误属性：

assertThrows(
  () => { throw new CustomError(-1) },
  CustomError,
  { code: -1 }
)

技术权衡

回调函数方案的优势：

• 灵活性高，可以处理复杂的验证逻辑
• 支持深度属性检查和自定义验证逻辑

属性对象方案的优势：

• 声明式语法更简洁
• 对于简单属性检查更直观

最佳实践建议

根据Deno核心团队的反馈，当前推荐的做法是：

1. 先使用基础断言捕获错误对象
2. 然后对错误对象进行额外的属性断言

const err = assertThrows(() => mightThrow());
assertEquals(err.code, -1);

这种分离的写法虽然多了一行代码，但保持了API的简洁性，同时提供了最大的灵活性。

总结

Deno标准库在错误断言方面提供了基础但强大的功能。虽然目前没有直接支持非message属性的验证，但通过合理的代码组织，开发者完全可以实现各种复杂的错误验证场景。这种设计体现了Deno团队对API简洁性和正交性的坚持，也鼓励开发者编写更清晰、更模块化的测试代码。