• Throws an AssertionError with the provided error message or a default error message. If the message parameter is an instance of an Error then it will be thrown instead of the AssertionError.

    import assert from 'node:assert/strict';

    assert.fail();
    // AssertionError [ERR_ASSERTION]: Failed

    assert.fail('boom');
    // AssertionError [ERR_ASSERTION]: boom

    assert.fail(new TypeError('need array'));
    // TypeError: need array

    Using assert.fail() with more than two arguments is possible but deprecated. See below for further details.

    Parameters

    • Optionalmessage: string | Error

    Returns never

    v0.1.21

  • Parameters

    • actual: unknown
    • expected: unknown
    • Optionalmessage: string | Error
    • Optionaloperator: string
    • OptionalstackStartFn: Function

    Returns never

    since v10.0.0 - use fail([message]) or other assert functions instead.