IO.js Console

稳定度: 2 - 稳定

这个模块定义了一个控制台类，并且暴露了一个console对象。

console对象是一个特殊的Console实例，它的输出被传至stdout或stderr。

为了使用的方便，console被定义为一个全局对象，不需要通过require就可直接使用。

console

• Object

用来向stdout和stderr打印信息。与大多数浏览器提供的console对象的功能类似，只是这里输出被传至stdout或stderr。

当目的地是终端或文件时（为了避免过早退出丢失信息），console函数时同步的。当目的地是管道时（为了避免长时间阻塞），console函数时异步的。

下面的例子里，stdout是非阻塞的，stderr是阻塞的：

$ node script.js 2> error.log | tee info.log

日常使用时，除了你需要记录大量数量的数据，你不用担心阻塞/非阻塞。

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

向stdout打印一行新信息。这个函数可以像printf()那样接受多个参数，例子：

var count = 5;
console.log('count: %d', count);
// prints 'count: 5'

如果第一个字符串中没有发现格式化元素，那么util.inspect将被应用到各个参数。详情参阅util.format()。

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

与console.log相同。

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

与console.log相同。但是输出至stderr。

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

与console.err相同。

console.dir(obj[, options])

对obj调用util.inspect并且将结果字符串输出至stdout。这个函数会忽略obj上的任何自定义inspect()函数。一个可选的options参数可以被传递用来格式化字符串的某些方面：

• showHidden - 如果为true，object的不可枚举和标志属性也会被显示。默认为false。

• depth - 告诉inspect在格式化对象时递归多少次。在检查大而复杂的对象时很有用。默认为2。若要递归到底则传递null。

• colors - 如果为true，那么输出会以ANSI颜色码的形式输出。默认为false。颜色是可以自定义，参阅下文。

console.time(label)

被用来计算指定操作之间时间间隔。为了开始一个timer，调用console.time()方法，作为唯一参数可以给它一个名字。为了关闭一个timer，并且得到毫秒间隔，仅仅以相同的名字参数调用一次console.timeEnd()。

console.timeEnd(label)

停止一个之前通过console.time()开启的timer，并且向控制台打印结果。

例子：

console.time('100-elements');
for (var i = 0; i < 100; i++) {
  ;
}
console.timeEnd('100-elements');
// prints 100-elements: 262ms

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

向stderr打印'Trace :'，跟随着格式化信息和堆栈信息。

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

与assert.ok()类似，但是错误信息被像util.format(message...)一样格式化。

Class: Console

使用require('console')后。Console或console.Console可以取得这个类。

var Console = require('console').Console;
var Console = console.Console;

你可以调用Console类来自定义如console一样的简单日记记录器，但是有不同的输出流。

new Console(stdout[, stderr])

通过传递一个或两个可写流实例，创建一个新的Console。stdout是一个用来打印日志和信息的输出流。stderr是一个被用来打印警告和错误输出的。如果stderr没有被传递，那么警告和错误信息将被传递至stdout。

var output = fs.createWriteStream('./stdout.log');
var errorOutput = fs.createWriteStream('./stderr.log');
// custom simple logger
var logger = new Console(output, errorOutput);
// use it like console
var count = 5;
logger.log('count: %d', count);
// in stdout.log: count 5

全局的console是一个特殊的Console实例，它的输出被传递至process.stdout和process.stderr：

new Console(process.stdout, process.stderr);