assertThrows | /testing/asserts.ts | std@0.220.1

function assertThrows

import { assertThrows } from "https://deno.land/std@0.220.1/testing/asserts.ts";

Deprecated

(will be removed after 1.0.0) Import from https://deno.land/std/assert/assert_throws.ts instead.

assertThrows(fn: () => unknown, msg?: string): unknown

Executes a function, expecting it to throw. If it does not, then it throws.

Deprecated

(will be removed after 1.0.0) Import from https://deno.land/std/assert/assert_throws.ts instead.

assertThrows<E extends Error = Error>(

fn: () => unknown,

ErrorClass: new (...args: any[]) => E,

msgIncludes?: string,

msg?: string,

): E

Executes a function, expecting it to throw. 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.

Executes a function, expecting it to throw. If it does not, then it throws.

Examples

Example 1

import { assertThrows } from "https://deno.land/std@0.220.1/testing/asserts.ts";

assertThrows(() => { throw new TypeError("hello world!"); }); // Doesn't throw
assertThrows(() => console.log("hello world!")); // Throws

Parameters

fn: () => unknown

optional

msg: string

Returns

unknown

Executes a function, expecting it to throw. 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.

Examples

Example 1

import { assertThrows } from "https://deno.land/std@0.220.1/testing/asserts.ts";

assertThrows(() => { throw new TypeError("hello world!"); }, TypeError); // Doesn't throw
assertThrows(() => { throw new TypeError("hello world!"); }, RangeError); // Throws

Type Parameters

optional

E extends Error = Error

Parameters

fn: () => unknown

ErrorClass: new (...args: any[]) => E

optional

msgIncludes: string

optional

msg: string