assert.fail([message])


使用提供的错误信息或默认错误信息抛出 AssertionError。如果 message 参数是 Error 的实例,则会抛出该实例而不是 AssertionError

【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 arrayconst assert = require('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

使用 assert.fail() 时传入两个以上的参数是可行的,但已被弃用。详见下文说明。

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