Skip to main content
Using Deno in production at your company? Earn free Deno merch.
Give us feedback
Module

std/testing/asserts.ts>assertThrows

The Deno Standard Library
Latest
function assertThrows
import { assertThrows } from "https://deno.land/std@0.224.0/testing/asserts.ts";

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.224.0/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.224.0/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