Node.js v14.20.0 文档

Console 类#

中英对照

Console 类可用于创建具有可配置输出流的简单记录器，并可使用 require('console').Console 或 console.Console（或它们的解构对应物）访问：

new Console(stdout[, stderr][, ignoreErrors])#

new Console(options)#

中英对照

使用一个或两个可写流实例创建新的 Console。 stdout 是用于打印日志或信息输出的可写流。 stderr 用于警告或错误输出。 如果未提供 stderr，则 stdout 用于 stderr。

console.assert(value[, ...message])#

中英对照

如果 value 为假值或省略，则 console.assert() 写入一条消息。 它只写入一条消息，不会影响执行。 输出始终以 "Assertion failed" 开头。 如果提供，则使用 util.format() 格式化 message。

console.clear()#

中英对照

当 stdout 是终端时，调用 console.clear() 将尝试清除终端。 当 stdout 不是终端时，此方法不执行任何操作。

console.count([label])#

中英对照

维护一个特定于 label 的内部计数器，并向 stdout 输出使用给定 label 调用 console.count() 的次数。

console.countReset([label])#

中英对照

重置特定于 label 的内部计数器。

console.debug(data[, ...args])#

中英对照

console.debug() 函数是 console.log() 的别名。

console.dir(obj[, options])#

中英对照

在 obj 上使用 util.inspect() 并将结果字符串打印到 stdout。 此函数绕过在 obj 上定义的任何自定义 inspect() 函数。

console.dirxml(...data)#

中英对照

此方法调用 console.log() 将接收到的参数传给它。 此方法不会产生任何 XML 格式。

console.error([data][, ...args])#

中英对照

使用换行符打印到 stderr。 可以传入多个参数，其中第一个用作主要消息，所有其他参数用作类似于 printf(3) 的替换值（所有参数都传给 util.format()）。

console.group([...label])#

中英对照

将后续行的缩进增加 groupIndentation 长度的空格。

console.groupCollapsed()#

中英对照

console.group() 的别名。

console.groupEnd()#

中英对照

将后续行的缩进减少 groupIndentation 长度的空格。

console.info([data][, ...args])#

中英对照

console.info() 函数是 console.log() 的别名。

console.log([data][, ...args])#

中英对照

使用换行符打印到 stdout。 可以传入多个参数，其中第一个用作主要消息，所有其他参数用作类似于 printf(3) 的替换值（所有参数都传给 util.format()）。

console.table(tabularData[, properties])#

中英对照

尝试用 tabularData 的属性的列（或使用 properties）和 tabularData 的行构建表格并记录它。 如果无法将其解析为表格，则回退到仅记录参数。

console.time([label])#

中英对照

启动可用于计算操作持续时间的计时器。 计时器由唯一的 label 标识。 调用 console.timeEnd() 时使用相同的 label 停止计时器并将经过的时间以合适的时间单位输出到 stdout。 例如，如果经过的时间是 3869 毫秒，则 console.timeEnd() 显示“3.869s”。

console.timeEnd([label])#

中英对照

停止之前通过调用 console.time() 启动的计时器并将结果打印到 stdout：

console.timeLog([label][, ...data])#

中英对照

对于先前通过调用 console.time() 启动的计时器，将经过时间和其他 data 参数打印到 stdout：

console.trace([message][, ...args])#

中英对照

将字符串 'Trace: ' 打印到 stderr，然后是 util.format() 格式的消息和到代码中当前位置的堆栈跟踪。

console.warn([data][, ...args])#

中英对照

console.warn() 函数是 console.error() 的别名。

仅用于检查器的方法#

中英对照

以下方法由 V8 引擎在通用 API 中公开，但不显示任何内容，除非与检查器结合使用（--inspect 标志）。

console.profile([label])#

中英对照

除非在检查器中使用，否则此方法不会显示任何内容。 console.profile() 方法启动带有可选标签的 JavaScript CPU 配置文件，直到调用 console.profileEnd()。 然后将配置文件添加到检查器的配置文件面板中。

console.profileEnd([label])#

中英对照

除非在检查器中使用，否则此方法不会显示任何内容。 如果已启动，则停止当前的 JavaScript CPU 分析会话并将报告打印到检查器的配置文件面板。 有关示例，请参见 console.profile()。

console.timeStamp([label])#

中英对照

除非在检查器中使用，否则此方法不会显示任何内容。 console.timeStamp() 方法将带有标签 'label' 的事件添加到检查器的时间轴面板。