Deno标准库中异步函数异常断言的最佳实践

在Deno标准库测试中，正确处理异步函数的异常断言是一个常见但容易出错的操作。本文将深入探讨如何正确使用assertRejects和assertThrows来测试异步函数，并解释其中的关键细节。

异步函数异常断言的基本用法

Deno标准库提供了assertRejects和assertThrows两个断言函数，分别用于处理异步和同步函数的异常情况。

对于简单的异步函数抛出异常的情况，可以直接使用assertRejects：

async function simpleAsyncThrow() {
  throw new Error("直接抛出错误");
}

// 正确用法
assertRejects(simpleAsyncThrow);

带参数的异步函数测试

当异步函数需要传递参数时，必须使用箭头函数包裹：

async function asyncWithParam(param: string) {
  throw new Error(`带参数的错误: ${param}`);
}

// 正确用法
assertRejects(() => asyncWithParam("test"));

包含await操作的异步函数测试

对于包含实际异步操作(如fetch)的函数，测试时需要特别注意：

async function asyncWithFetch(format = "json") {
  const res = await fetch(`https://api.example.com?format=${format}`);
  await res.text(); // 必须消费响应体
  throw new Error("获取数据后抛出错误");
}

正确的测试写法需要同时满足：

1. 使用assertRejects
2. 添加await关键字
3. 使用箭头函数传递参数
4. 确保消费了所有异步资源

// 正确写法
await assertRejects(() => asyncWithFetch("json"));

常见错误与解决方案

错误1：忘记消费响应体

// 错误写法 - 会导致资源泄漏
assertRejects(() => asyncWithFetch("json"));

解决方案：确保在测试函数中消费了所有异步资源，如响应体。

错误2：混淆assertRejects和assertThrows

// 错误写法 - assertThrows不适用于异步函数
assertThrows(async () => await asyncWithFetch("json"));

解决方案：对于异步函数总是使用assertRejects，对于同步函数使用assertThrows。

错误3：忘记await关键字

// 错误写法 - 可能导致测试在断言完成前结束
assertRejects(() => asyncWithFetch("json"));

解决方案：在assertRejects前添加await关键字。

最佳实践总结

1. 对于纯异步函数(不包含实际IO)，可以直接使用assertRejects(func)
2. 对于需要传参的异步函数，使用assertRejects(() => func(param))
3. 对于包含实际IO操作的异步函数：
   • 使用await assertRejects(() => func(param))
   • 确保函数内部消费了所有IO资源
4. 区分清楚assertRejects(异步)和assertThrows(同步)的使用场景
5. 在测试文件中明确标记async/await，避免遗漏

通过遵循这些实践，可以确保在Deno测试中正确处理异步函数的异常断言，避免资源泄漏和测试不稳定的情况。