[[@std.assert (Deno)|@std/asset]]の関数。[[Promise (JavaScript)|Promise]]を返すような非同期関数を第1引数にとり、エラーがthrowされることを期待する。第2引数にエラークラスを指定した場合は、第3引数でエラーメッセージの部分一致アサーションも可能。
```js
import { assertRejects } from "@std/assert";
function asyncThrowError() {
return new Promise((_, reject) => {
reject(new Error("async error"));
});
}
Deno.test("asyncThrowError - 期待通りのメッセージを含むエラーを返す", async () => {
await assertRejects(asyncThrowError, Error, "error");
});
Deno.test("asyncThrowError 期待通りのメッセージを含まないエラーを返す", async () => {
await assertRejects(asyncThrowError, Error, "foo");
});
```