Skip to main content
Deno 2 is finally here 🎉️
Learn more
Go to Latest
The Standard Library has been moved to JSR. See the blog post for details.
function assertRejects
import { assertRejects } from "https://deno.land/std@0.116.0/testing/asserts.ts";

Executes a function which returns a promise, expecting it to throw or reject. If it does not, then it throws. An error class and a string that should be included in the error message can also be asserted. Or you can pass a callback which will be passed the error, usually to apply some custom assertions on it.

Type Parameters

optional
E extends Error = Error

Parameters

fn: () => Promise<unknown>
optional
ErrorClass: new (...args: any[]) => E
optional
msgIncludes: string
optional
msg: string

Returns

Promise<void>

Parameters

fn: () => Promise<unknown>
errorCallback: (e: Error) => unknown
optional
msg: string

Returns

Promise<void>

Type Parameters

optional
E extends Error = Error

Parameters

fn: () => Promise<unknown>
optional
errorClassOrCallback: (new (...args: any[]) => E) | ((e: Error) => unknown)
optional
msgIncludesOrMsg: string
optional
msg: string

Returns

Promise<void>