首页 > 代码库 > Node.js API —— console(控制台)

Node.js API —— console(控制台)

 // 说明
    Node API 版本为 v0.10.31。
    中文参考:http://blog.sina.com.cn/oleoneoy
    本段为博主注解。

目录

● 控制台
    ○ console.log([data], [...])
    ○ console.info([data], [...])
    ○ console.error([data], [...])
    ○ console.warn([data], [...])
    ○ console.dir(obj)
    ○ console.time(label)
    ○ console.timeEnd(label)
    ○ console.trace(message, [...])
    ○ console.assert(value, [message], [...])

控制台

稳定性:4 - API冻结

    ● 对象
    用于向标准输出和标准错误输出打印。与大多数 web 浏览器提供的控制台对象函数类似,这里的输出也是发送给标准输出和标准错误输出。
    当输出目标是终端或文件,控制台函数都是同步的(以防过早退出丢失信息);当目标是管道的时候,它是异步的(以防长时间的阻塞)。
    因此,在下面的例子中,标准输出是非阻塞的同时标准错误输出是阻塞的。

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

     在日常的使用中,阻塞/非阻塞的区别并不是你应该担心的,除非你记录庞大的数据。

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

    向标准输出另起一行打印。此函数可以使用 printf() 类似的方式带多个参数。例如:

1 console.log(‘count: %d‘, count);

    如果第一个字符串参数不是格式化字符串,则 util.inspect 将应用到每个参数上。更多信息参看 util.format()
// 实际上是,当遇到第一个不能传入格式化字符串的参数时,其及其后所有的参数,都用 util.inspect 转换成字符串,各参数之间用空格分隔。
// %d 为输出整数,%s 为输出字符串,%j 为输出 JSON 的字符串格式

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

    与 console.log 相同。

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

    与 console.log 相同,只是向标准错误输出打印。  

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

    与 console.error 相同。 

console.dir(obj)

    对 obj 使用 util.inspect 并将结果字符串向标准输出打印。 

console.time(label)

    标记一个时间。

console.timeEnd(label)

    结束一个定时器,记录输出。例子:

1 console.time(‘100-elements‘);2 for (var i = 0; i < 100; i++) {3     ;4 }5 console.timeEnd(‘100-elements‘);

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

    打印格式化的信息和当前位置的堆栈信息到标准错误输出,以上输出紧跟在 ‘Trace: ‘ 后面。

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

    类似 assert.ok(),但错误信息使用 util.format(message...) 格式化。

Node.js API —— console(控制台)