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...) 格式化。