使用 console.log() 時,firebug 一定要處於開啟狀態。否則在 Firefox 中這個函式不但無效,還會中斷後續程式碼執行;用 IE 打開則直接報錯。這是早期前端除錯最常踩的一腳。
第一個參數可以是含格式化佔位符的字串:
console.log("The %s jumped over %d tall buildings", animal, count);
支援的佔位符:
%s:字串%d、%i:整數(當時數字格式化尚未支援)%f:浮點數(當時數字格式化尚未支援)%o:連結物件console.log 原先是安裝了 firebug 之後的 Firefox 專利。IE8 跟進了,但只有開啟除錯視窗(F12)時才有結果,否則報錯。Opera 的 dragonfly 雖然已經能與 firebug 匹敵,卻仍不支援 console.log,於是有這兩行:
window.console = window.console || {};
console.log || (console.log = opera.postError);
實測有效。至此 Firefox/IE/Opera 都能用上 console.log。當然,IE 與 Opera 下的 console.log 比起 firebug 原版仍過於簡單,比如參數是物件或陣列時沒有進一步的展開顯示能力。
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>javascript 的 console.log() 用法</title>
<script type="text/javascript">
window.console = window.console || {};
console.log || (console.log = opera.postError);
// 變數
var i = 'I am a string';
console.log('變量:', i);
// 陣列
var arr = [1, 2, 3, 4, 5];
console.log('數組:', arr);
// 物件
var obj1 = { key1: 'value1', key2: 'value2', key3: 'value3' };
var obj2 = { key6: 'value4', key5: 'value5', key4: 'value6' };
var obj3 = { key9: 'value7', key8: 'value8', key7: 'value9' };
console.log('對象:', obj1);
// 物件陣列
console.log('對象數組1:', [obj1, obj2, obj3]);
console.log('對象數組2:', [[obj1], [obj2], [obj3]]);
</script>
</head>
<body></body>
</html>
輸出結果大致如下:
變量:I am a string
數組:[1, 2, 3, 4, 5]
對象:Object { key1="value1", key2="value2", key3="value3"}
對象數組1:[Object { key1="value1", ...}, Object { key6="value4", ...}, ...]
上面那個 window.console = window.console || {} 的 shim 在 IE8 之後已無必要,因為所有現代瀏覽器都內建 console。但要提醒一個仍然存在的陷阱:若除錯工具未開啟,某些舊版瀏覽器(特別是 IE9 以下的行動版與部分嵌入式 webview)中的 console 是 undefined,直接呼叫就會拋錯並中斷腳本。因此正式環境中若殘留了 console 呼叫,仍建議做保護。
另外幾個實用補充:
console.log(obj) 印物件——除錯工具顯示的是參照,展開時看到的是當下最新的值而非印出當時的快照。要看當時狀態請用 console.log(JSON.stringify(obj)) 或 console.table(obj)。console.table() 對陣列與物件列表的呈現遠比 log 清楚。console.group()/groupEnd() 可把大量輸出分組折疊。console.time()/timeEnd() 是量測效能最直接的工具。console.count() 可確認某段程式碼被執行了幾次。