萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 調試利器 console.log 完整指南:語法、格式化、級別、兼容性

為什麼不用 alert?

  • alert() 阻塞主線程,改變執行時序,隱藏競態 Bug。
  • alert() 無法輸出對象結構,只能 [object Object]。
  • console.log() 非阻塞、支援對象交互展開、時間戳、堆疊追蹤、分組、樣式化輸出。

基礎語法

console.log('Hello');                    // 字符串
console.log(123, true, {a:1}, [1,2]);    // 多參數空格分隔
console.log('User: %s, Age: %d', 'Tom', 20); // C 風格佔位符
console.log('%c Styled', 'color:red;font-size:20px;'); // CSS 樣式

支援的格式化佔位符

佔位符類型示例
%s字符串console.log('%s', 'str')
%d / %i整數console.log('%d', 42)
%f浮點數console.log('%f', 3.14)
%oDOM 元素(可點擊跳轉 Elements 面板)console.log('%o', document.body)
%OJavaScript 對象(可展開屬性)console.log('%O', {a:1})
%cCSS 樣式(後續參數為樣式字符串)console.log('%cRed', 'color:red')

日誌級別與過濾

console.log('普通信息');
console.info('提示信息');      // 藍色圖標
console.warn('警告');          // 黃色圖標,堆疊追蹤
console.error('錯誤');         // 紅色圖標,堆疊追蹤
console.debug('調試');         // 默認隱藏,需開啟 Verbose

DevTools Console 面板可按級別過濾(All/Errors/Warnings/Info/Verbose)。

進階功能

分組

console.group('用戶登錄流程');
console.log('驗證用戶名...');
console.group('密碼校驗');
console.log('哈希比對...');
console.groupEnd();
console.groupEnd();

計時

console.time('ajax-request');
fetch('/api').then(() => console.timeEnd('ajax-request')); // 輸出: ajax-request: 245.32ms

// 標籤計時器(可多次 timeLog)
console.time('loop');
for (var i=0; i<1e6; i++) {}
console.timeLog('loop'); // 中間點
console.timeEnd('loop');

表格輸出

console.table([{id:1,name:'A'},{id:2,name:'B'}]);
// ┌─────────┬────┬───────┐
// │ (index) │ id │ name  │
// ├─────────┼────┼───────┤
// │    0    │ 1  │ 'A'   │
// │    1    │ 2  │ 'B'   │
// └─────────┴────┴───────┘

斷言

console.assert(1 === 2, 'Assertion failed: 1 !== 2'); // 僅條件為 false 時輸出錯誤

堆疊追蹤

function foo() { console.trace('trace point'); }
foo(); // 輸出完整調用棧

兼容性處理:無 Console 環境不報錯

// 頁面最早引入,或打包工具注入
(function() {
    if (window.console && window.console.log) return;
    var noop = function() {};
    var methods = ['log','info','warn','error','debug','time','timeEnd','timeLog','group','groupEnd','groupCollapsed','trace','assert','table','dir','dirxml','clear','count','countReset','profile','profileEnd'];
    window.console = {};
    methods.forEach(function(m) { window.console[m] = noop; });
    // 兼容 console.log.apply 調用
    window.console.log.apply = function() { noop.apply(this, arguments); };
})();

構建流程中生產環境應移除所有 console.*(Terser drop_console: true),開發環境保留。

Firebug 歷史注記

早期 Firefox 無內建開發工具,需安裝 Firebug 插件。現代 Firefox DevTools 已完整內建上述功能,Firebug 於 2017 年停止維護。

Node.js 環境差異

  • 無 %c 樣式支援。
  • console.table 輸出文本表格而非交互表格。
  • 可用 util.inspect(obj, {depth: null, colors: true}) 獲取完整對象字符串。

善用 Console API,讓調試從「盲人摸象」變為「全景透視」。

copyright © 萬盛學電腦網 all rights reserved