Node.js v18.7.0 文档


目录

console 控制台#

中英对照

node:console 模块提供了一个简单的调试控制台,类似于网络浏览器提供的 JavaScript 控制台机制。

    
    

    
    

    Console#

    中英对照

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

    
    
    
    

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

    new Console(options)#

    中英对照

      使用一个或两个可写流实例创建新的 Consolestdout 是用于打印日志或信息输出的可写流。 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' 的事件添加到检查器的时间轴面板。

                                            返回顶部