Node.js v0.10.31API手冊-文件夹
控制台
- Object
用于向 stdout 和 stderr 打印字符。类似于大部分 Web 浏览器提供的 console 对象函数,在这里则是输出到 stdout 或 stderr。
当输出目标是一个终端或者文件时,console函数是同步的(为了防止过早退出时丢失信息).当输出目标是一个管道时它们是异步的(防止堵塞过长时间)。
也就是说,在以下的样例中,stdout
是非堵塞的,而 stderr 则是堵塞的。
$ node script.js 2> error.log | tee info.log
在日常使用中,您不须要太操心堵塞/非堵塞的区别,除非您须要记录大量数据。
console.log([data], [...])
向 stdout 打印并新起一行。这个函数能够像 printf()
那样接受多个參数,比如:
console.log('count: %d', count);
假设在第一个字符串中没有找到格式化元素,那么 util.inspect
将被应用到各个參数。详见 util.format()。
console.info([data], [...])
同 console.log
。
console.error([data], [...])
同 console.log
,但输出到
stderr。
console.warn([data], [...])
同 console.error
。
console.dir(obj)
对 obj
使用 util.inspect
并将结果字符串输出到
stdout。这个函数会忽略 obj
上的不论什么自己定义 inspect()
。
console.time(label)
标记时间。
console.timeEnd(label)
结束计时器,记录输出。演示样例:
console.time('100-elements');
for (var i = 0; i < 100; i++) {
;
}
console.timeEnd('100-elements');
console.trace(message, [...])
通过格式化的消息以及堆栈轨迹到当前位置来输出stderr 'Trace
。
:'
console.assert(value, [message], [...])
与 assert.ok() 同样,可是错误消息使用 util.format(message...)
来格式化的。