當你想知道某段程式是「從哪裡被呼叫」的,console.trace 能幫你把當前的呼叫堆疊(call stack)打印出來,是除錯時追蹤呼叫來源的好幫手。
它會向標準錯誤流輸出當前的呼叫堆疊。
console.trace(label)
console.trace();
// 運行結果:
Trace:
at Object.<anonymous> (/home/byvoid/consoletrace.js : 1: 71)
at Module._compile (module.js:441:26)
at Object..js (module.js:459:10)
at Module.load (module.js:348:31)
at Function._load (module.js:308:12)
at Array.0 (module.js:479:10)
at EventEmitter._tickCallback (node.js:192:40)
從這份堆疊,你能清楚看到函式被一層層呼叫的完整路徑。
它會建立一個 Error 物件,把名稱設為 'Trace'、訊息設為格式化後的參數,再擷取堆疊資訊並交給 error 印出:
Console.prototype.trace = function() {
var err = new Error;
err.name = 'Trace';
err.message = util.format.apply(this, arguments);
Error.captureStackTrace(err, arguments.callee);
this.error(err.stack);
};
正因為它輸出到 stderr,所以能與一般的 log 輸出區隔開來,非常適合用來標記關鍵的執行節點。