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

Module

std/testing/asserts.ts>assertIsError

Deno standard library

denoland/deno_std

assertNotStrictEquals

Spy

spy

Has

The Standard Library has been moved to JSR. See the blog post for details.

function assertIsError

Deprecated

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

import { assertIsError } 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_is_error.ts instead.

assertIsError<E extends Error = Error>(

error: unknown,

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

msgMatches?: string | RegExp,

msg?: string,

): asserts error is E

Make an assertion that error is an Error. If not then an error will be thrown. An error class and a string that should be included in the error message can also be asserted.

Examples

Example 1

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

assertIsError(null); // Throws
assertIsError(new RangeError("Out of range")); // Doesn't throw
assertIsError(new RangeError("Out of range"), SyntaxError); // Throws
assertIsError(new RangeError("Out of range"), SyntaxError, "Out of range"); // Doesn't throw
assertIsError(new RangeError("Out of range"), SyntaxError, "Within range"); // Throws

Type Parameters

optional

E extends Error = Error

Parameters

error: unknown

optional

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

optional

msgMatches: string | RegExp

optional

msg: string

Returns

asserts error is E