Skip to main content
Deno 2 is finally here 🎉️
Learn more
Module

std/testing/asserts.ts

The Deno Standard Library
Go to Latest
The Standard Library has been moved to JSR. See the blog post for details.
Deprecated

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

import * as mod from "https://deno.land/std@0.222.1/testing/asserts.ts";

A library of assertion functions. If the assertion is false an AssertionError will be thrown which will result in pretty-printed diff of failing assertion.

This module is browser compatible, but do not rely on good formatting of values for AssertionError messages in browsers.

Classes

c
AssertionError
deprecated

Error thrown when an assertion fails.

Functions

f
assert
deprecated

Make an assertion, error will be thrown if expr does not have truthy value.

Make an assertion that actual and expected are almost equal numbers through a given tolerance. It can be used to take into account IEEE-754 double-precision floating-point representation limitations. If the values are not almost equal then throw.

Make an assertion that actual includes the expected values. If not then an error will be thrown.

f
assertEquals
deprecated

Make an assertion that actual and expected are equal, deeply. If not deeply equal, then throw.

f
assertExists
deprecated

Make an assertion that actual is not null or undefined. If not then throw.

f
assertFalse
deprecated

Make an assertion, error will be thrown if expr have truthy value.

f
assertGreater
deprecated

Make an assertion that actual is greater than expected. If not then throw.

Make an assertion that actual is greater than or equal to expected. If not then throw.

f
assertInstanceOf
deprecated

Make an assertion that obj is an instance of type. If not then throw.

f
assertIsError
deprecated

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.

f
assertLess
deprecated

Make an assertion that actual is less than expected. If not then throw.

Make an assertion that actual is less than or equal to expected. If not then throw.

f
assertMatch
deprecated

Make an assertion that actual match RegExp expected. If not then throw.

f
assertNotEquals
deprecated

Make an assertion that actual and expected are not equal, deeply. If not then throw.

Make an assertion that obj is not an instance of type. If so, then throw.

f
assertNotMatch
deprecated

Make an assertion that actual not match RegExp expected. If match then throw.

Make an assertion that actual and expected are not strictly equal. If the values are strictly equal then throw.

Make an assertion that actual object is a subset of expected object, deeply. If not, then throw.

f
assertRejects
deprecated

Executes a function which returns a promise, expecting it to reject.

Make an assertion that actual and expected are strictly equal. If not then throw.

Make an assertion that actual includes expected. If not then throw.

f
assertThrows
deprecated

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

f
equal
deprecated

Deep equality comparison used in assertions

f
fail
deprecated

Forcefully throws a failed assertion.

f
unimplemented
deprecated

Use this to stub out methods that will throw when invoked.

f
unreachable
deprecated

Use this to assert unreachable code.

Type Aliases

T
AnyConstructor
deprecated

Any constructor

T
ArrayLikeArg
deprecated

An array-like object (Array, Uint8Array, NodeList, etc.) that is not a string.

T
Falsy
deprecated

Assertion condition for assertFalse.

Gets constructor type