Console.assert()

如果断言为false,则将一个错误消息写入控制台。如果断言是 true,没有任何反应。

Note: 此特性在 Web Worker 中可用。

console.assert()方法在Node.js中的实现和浏览器中可用的console.assert()方法实现是不同的。在浏览器中当console.assert()方法接受到一个值为假断言的时候,会向控制台输出传入的内容,但是并不会中断代码的执行,而在Node.js v10.0.0之前,一个值为假的断言也将会导致一个AssertionError被抛出,使得代码执行被打断。v10.0.0修复了此差异,所以现在console.assert()在Node 和浏览器中执行行为相同 。

语法

console.assert(assertion, obj1 [, obj2, ..., objN]);
console.assert(assertion, msg [, subst1, ..., substN]); // c-like message formatting

参数

assertion
一个布尔表达式。如果assertion为假,消息将会被输出到控制台之中。
obj1 ... objN
被用来输出的Javascript对象列表,最后输出的字符串是各个对象依次拼接的结果。
msg
一个包含零个或多个子串的Javascript字符串。
subst1 ... substN
各个消息作为字串的Javascript对象。这个参数可以让你能够控制输出的格式。

案例

下面的代码示例演示了JavaScript对象的使用:

const errorMsg = 'the # is not even';
for (let number = 2; number <= 5; number += 1) {
    console.log('the # is ' + number);
    console.assert(number % 2 === 0, {number: number, errorMsg: errorMsg});
    // 或者使用 ES2015 对象简写:
    // console.assert(number % 2 === 0, {number, errorMsg});
}
// 输出:
// the # is 2
// the # is 3
// Assertion failed: {number: 3, errorMsg: "the # is not even"}
// the # is 4
// the # is 5
// Assertion failed: {number: 5, errorMsg: "the # is not even"}

请注意, 你可以在大多数浏览器中使用 console.log 进行格式化输出

console.log('the word is %s try number %d', 'foo', 123);
// 输出: the word is foo try number 123

但是 console.assert 在不同浏览器中可能获得不同的效果:

console.assert(false, 'the word is %s', 'foo');
// correct output in Node (e.g. v8.10.0) and some browsers
//     (e.g. Firefox v60.0.2):
// Assertion failed: the word is foo
// incorrect output in some browsers
//     (e.g. Chrome v67.0.3396.87):
// Assertion failed: the word is %s foo

有关详细信息,请参阅 console 文档中的 输出文本到控制台

规范

Specification Status Comment
Console API
console.assert()
Living Standard Initial definition

浏览器兼容性

BCD tables only load in the browser

相关链接