DIV CSS 佈局教程網

攔截 console.log 的輸出:讓除錯訊息能被程式讀取
編輯:關於JavaScript     

console.log() 把訊息印到開發者工具裡給人看,但程式本身拿不到這些內容。若你想在頁面顯示除錯資訊、或把 log 收集起來回傳給後端,就得攔下它。

思路很單純:先把原本的 console.log 存起來,再換成自己的實作。

var lastLog;

console.oldLog = console.log;
console.log = function (str) {
  console.oldLog(str);   // 保持原本行為,訊息照樣印到 devtools
  lastLog = str;         // 同時存起來
};

console.log("Hello, Neo");
document.write(lastLog);   // Hello, Neo

更完整的版本:收集成陣列

只存最後一筆通常不夠,實務上更想保留全部:

(function () {
  var logs = [];
  var original = console.log.bind(console);

  console.log = function () {
    // 把參數轉成真陣列,支援多參數呼叫
    var args = Array.prototype.slice.call(arguments);
    logs.push(args);

    // 交回原函式處理,devtools 裡照樣看得到
    original.apply(console, args);
  };

  // 提供一個取用管道
  window.getLogs = function () {
    return logs.slice();     // 回傳複本,避免外部改動
  };

  window.clearLogs = function () {
    logs.length = 0;
  };
})();

這裡有兩個細節值得注意:一是用 bind(console) 保住原本的 this 指向,否則呼叫時可能出錯;二是用 arguments 搭配 slice 支援多參數,因為 console.log('a', 'b', 'c') 是很常見的寫法。

實務上的應用

在行動裝置上除錯。手機沒有 devtools,把 log 收集起來顯示在頁面上,或用手機連電腦看,是非常實用的技巧。

把前端錯誤回報到後端。搭配 window.onerror,可以在使用者遇到問題時把 log 一併送出,大幅降低排查成本。

環境切換。正式環境關掉所有 log,開發環境保留:

if (location.hostname === 'localhost') {
  // 保留 log
} else {
  console.log = function () {};    // 正式環境靜音
}

幾個提醒

記得 restore。覆寫全域函式是侵入性行為,除錯結束後應該還原,否則同一頁上的其他程式碼會莫名其妙被影響。

也攔一下其他方法。實務上 console.warn、console.error、console.info 同樣需要處理,否則訊息會從別的管道溜走。

注意物件參數是引用。若傳入的是物件,存起來的只是參照,之後物件內容變了,log 也跟著變。要保存當時的快照,得用 JSON.parse(JSON.stringify(obj)) 或 structuredClone(obj) 做深拷貝。

更推薦的做法。与其覆寫 console,不如自己寫一層 logger 模組,讓全團隊統一透過它輸出。這樣可控性更高,也不必擔心污染全域。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved