Jasmine测试框架中toBeRejectedWithError的错误信息优化

在JavaScript测试框架Jasmine中，toBeRejectedWithError是一个用于验证Promise是否被拒绝并抛出特定错误的异步匹配器。然而，当开发者错误地将非Promise对象传递给expectAsync时，当前的错误信息"Expected toBeRejectedWithError to be called on a promise"可能不够清晰，导致调试困难。

问题背景

在实际开发中，特别是使用TypeScript时，类型系统允许开发者将任何类型的值传递给expectAsync函数。当开发者不小心传递了非Promise对象（如普通值、同步函数等）时，Jasmine会抛出上述错误信息。这个信息虽然正确，但缺乏足够的上下文，无法帮助开发者快速定位问题。

改进方案

社区提出的改进方案是增强错误信息的描述性，使其包含以下关键信息：

1. 期望接收的类型（Promise）
2. 实际接收到的值的类型
3. 明确的错误定位

改进后的错误信息格式为："toBeRejectedWithError expected a promise to be passed to expectAsync but a [实际类型] was passed instead."

技术实现

要实现这一改进，需要在Jasmine的异步匹配器逻辑中添加类型检查。当检测到传入值不是Promise时，应该：

1. 使用typeof或instanceof操作符确定实际值的类型
2. 构造包含实际类型信息的错误消息
3. 抛出带有改进后错误信息的异常

实际影响

这一改进将显著提升开发体验：

• 减少调试时间：开发者能立即知道他们错误传递了什么类型的值
• 提高代码质量：更清晰的错误信息有助于快速发现和修复问题
• 降低学习曲线：新手开发者更容易理解错误原因

最佳实践

为避免此类问题，开发者应该：

1. 确保传递给expectAsync的确实是Promise对象
2. 在TypeScript项目中，考虑添加自定义类型守卫来验证Promise类型
3. 在测试代码中添加注释说明异步测试的预期行为

这个改进已被合并到Jasmine主分支，将在未来的版本中发布。对于使用旧版本Jasmine的开发者，可以考虑在项目中实现类似的错误处理逻辑作为临时解决方案。