控制台：assert() 静态方法

注意：此功能在 Web Workers 中可用。

console.assert() 静态方法在断言为假时将错误消息写入控制台。如果断言为真，则不会发生任何事情。

语法

js
assert(assertion)

assert(assertion, val1)
assert(assertion, val1, val2)
assert(assertion, val1, val2, /* …, */ valN)

assert(assertion, msg)
assert(assertion, msg, subst1)
assert(assertion, msg, subst1, /* …, */ substN)

参数

断言

任何布尔表达式。如果断言为假，则会将一个通用的断言失败消息写入控制台。

val1 … valN

要输出的 JavaScript 值列表。这些值的表示形式按给定的顺序输出到控制台，在通用断言失败消息（可能与这些值不存在时输出的消息不同）之后，在消息之间以及它们之间进行某种类型的分隔。如果 obj1 是一个字符串，则有一个特殊情况，将在后面描述。

消息

包含一个或多个替换字符串的 JavaScript 字符串，这些字符串将被 subst1 到 substN 替换，依次替换，直到替换字符串数量。冒号、空格，然后是替换后的字符串将附加到通用的断言消息以形成详细的断言消息，并将结果输出到控制台。有关替换工作方式的描述，请参阅 使用字符串替换。

subst1 … substN

用于替换 msg 中替换字符串的 JavaScript 值。如果替换值的数量大于替换字符串的数量，则多余的值本身将在详细的断言消息之后以与没有格式字符串时相同的方式写入控制台。

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

返回值

无 (undefined).

示例

以下代码示例演示了在断言之后使用 JavaScript 对象。

js
const errorMsg = "the # is not even";
for (let number = 2; number <= 5; number++) {
  console.log(`the # is ${number}`);
  console.assert(number % 2 === 0, "%o", { number, errorMsg });
}
// output:
// 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"}

规范

规范
控制台标准
# 断言

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅