throws

View Source

Summary

Asserts that fn throws. Optionally validates the thrown error against expectedError, which may be an Error constructor, an Error instance (matched by message), a RegExp (matched against the error message), or a validator function that returns true for a valid error.

Signature

function throws(fn: () => any, expectedError: any, message: string): void;

Example

assert.throws(() => JSON.parse('invalid'))
assert.throws(() => riskyOp(), SyntaxError)

Params

fn

The function expected to throw.

expectedError

Optional error constructor, instance, RegExp, or validator.

message

Optional failure message.