JavaScript console對(duì)象

目錄

console對(duì)象是JavaScript的原生對(duì)象，它有點(diǎn)像Unix系統(tǒng)的標(biāo)準(zhǔn)輸出stdout和標(biāo)準(zhǔn)錯(cuò)誤stderr，可以輸出各種信息到控制臺(tái)，并且還提供了很多額外的有用方法。

它的常見用途有兩個(gè)。

• 調(diào)試程序，顯示網(wǎng)頁代碼運(yùn)行時(shí)的錯(cuò)誤信息。
• 提供了一個(gè)命令行接口，用來與網(wǎng)頁代碼互動(dòng)。

console對(duì)象的瀏覽器實(shí)現(xiàn)，包含在瀏覽器自帶的開發(fā)工具之中。以Chrome瀏覽器的“開發(fā)者工具”（Developer Tools）為例，可以使用下面三種方法的一種打開它。

1. 按F12或者Control + Shift + i（PC平臺(tái)）/ Alt + Command + i（Mac平臺(tái)）。
2. 在菜單中選擇“工具/開發(fā)者工具”。
3. 在一個(gè)頁面元素上，打開右鍵菜單，選擇其中的“Inspect Element”。

打開“開發(fā)者工具”以后，可以在頂端看到，有多個(gè)面板可供選擇，主要如下。

• Elements：查看網(wǎng)頁的HTML源碼和CSS代碼。
• Resources：查看網(wǎng)頁加載的各種資源文件（比如代碼文件、字體文件、css文件等），以及在硬盤上創(chuàng)建的各種內(nèi)容（比如本地緩存、Cookie、Local Storage等）。
• Network：查看網(wǎng)頁的HTTP通信情況。
• Sources：查看網(wǎng)頁加載的所有源碼。
• Timeline：查看各種網(wǎng)頁行為隨時(shí)間變化的情況。
• Profiles：查看網(wǎng)頁的性能情況，比如CPU和內(nèi)存消耗。
• Console：用來運(yùn)行JavaScript命令。

這些面板都有各自的用途，以下只介紹Console面板（又稱為控制臺(tái)）。

Console面板基本上就是一個(gè)命令行窗口，你可以在提示符下，鍵入各種命令。

console對(duì)象提供的各種方法，用來與控制臺(tái)窗口互動(dòng)。

log()，info()，debug()

console.log方法用于在console窗口輸出信息。它可以接受多個(gè)參數(shù)，將它們的結(jié)果連接起來輸出。

console.log('Hello World')
// Hello World

console.log('a', 'b', 'c')
// a b c

console.log方法會(huì)自動(dòng)在每次輸出的結(jié)尾，添加換行符。

console.log(1);
console.log(2);
console.log(3);
// 1
// 2
// 3

如果第一個(gè)參數(shù)是格式字符串（使用了格式占位符），console.log方法將依次用后面的參數(shù)替換占位符，然后再進(jìn)行輸出。

console.log(' %s + %s = %s', 1, 1, 2)
//  1 + 1 = 2

上面代碼中，console.log方法的第一個(gè)參數(shù)有三個(gè)占位符（%s），第二、三、四個(gè)參數(shù)會(huì)在顯示時(shí)，依次替換掉這個(gè)三個(gè)占位符。

console.log方法支持以下占位符，不同格式的數(shù)據(jù)必須使用對(duì)應(yīng)格式的占位符。

• %s 字符串
• %d 整數(shù)
• %i 整數(shù)
• %f 浮點(diǎn)數(shù)
• %o 對(duì)象的鏈接
• %c CSS格式字符串

var number = 11 * 9;
var color = 'red';

console.log('%d %s balloons', number, color);
// 99 red balloons

上面代碼中，第二個(gè)參數(shù)是數(shù)值，對(duì)應(yīng)的占位符是%d，第三個(gè)參數(shù)是字符串，對(duì)應(yīng)的占位符是%s。

使用%c占位符時(shí)，對(duì)應(yīng)的參數(shù)必須是CSS語句，用來對(duì)輸出內(nèi)容進(jìn)行CSS渲染。

console.log(
  '%cThis text is styled!',
  'color: red; background: yellow; font-size: 24px;'
)

上面代碼運(yùn)行后，輸出的內(nèi)容將顯示為黃底紅字。

console.log方法的兩種參數(shù)格式，可以結(jié)合在一起使用。

console.log(' %s + %s ', 1, 1, '= 2')
// 1 + 1  = 2

如果參數(shù)是一個(gè)對(duì)象，console.log會(huì)顯示該對(duì)象的值。

console.log({foo: 'bar'})
// Object {foo: "bar"}

console.log(Date)
// function Date() { [native code] }

上面代碼輸出Date對(duì)象的值，結(jié)果為一個(gè)構(gòu)造函數(shù)。

console.info()和console.debug()都是console.log方法的別名，用法完全一樣。只不過console.info方法會(huì)在輸出信息的前面，加上一個(gè)藍(lán)色圖標(biāo)。

console對(duì)象的所有方法，都可以被覆蓋。因此，可以按照自己的需要，定義console.log方法。

['log', 'info', 'warn', 'error'].forEach(function(method) {
  console[method] = console[method].bind(
    console,
    new Date().toISOString()
  );
});

console.log("出錯(cuò)了！");
// 2014-05-18T09:00.000Z 出錯(cuò)了！

上面代碼表示，使用自定義的console.log方法，可以在顯示結(jié)果添加當(dāng)前時(shí)間。

warn()，error()

warn方法和error方法也是在控制臺(tái)輸出信息，它們與log方法的不同之處在于，warn方法輸出信息時(shí)，在最前面加一個(gè)黃色三角，表示警告；error方法輸出信息時(shí)，在最前面加一個(gè)紅色的叉，表示出錯(cuò)，同時(shí)會(huì)顯示錯(cuò)誤發(fā)生的堆棧。其他方面都一樣。

console.error('Error: %s (%i)', 'Server is not responding', 500)
// Error: Server is not responding (500)

console.warn('Warning! Too few nodes (%d)', document.childNodes.length)
// Warning! Too few nodes (1)

可以這樣理解，log方法是寫入標(biāo)準(zhǔn)輸出（stdout），warn方法和error方法是寫入標(biāo)準(zhǔn)錯(cuò)誤（stderr）。

table()

對(duì)于某些復(fù)合類型的數(shù)據(jù)，console.table方法可以將其轉(zhuǎn)為表格顯示。

var languages = [
  { name: "JavaScript", fileExtension: ".js" },
  { name: "TypeScript", fileExtension: ".ts" },
  { name: "CoffeeScript", fileExtension: ".coffee" }
];

console.table(languages);

上面代碼的language變量，轉(zhuǎn)為表格顯示如下。

復(fù)合型數(shù)據(jù)轉(zhuǎn)為表格顯示的條件是，必須擁有主鍵。對(duì)于數(shù)組來說，主鍵就是數(shù)字鍵。對(duì)于對(duì)象來說，主鍵就是它的最外層鍵。

var languages = {
  csharp: { name: "C#", paradigm: "object-oriented" },
  fsharp: { name: "F#", paradigm: "functional" }
};

console.table(languages);

上面代碼的language，轉(zhuǎn)為表格顯示如下。

count()

count方法用于計(jì)數(shù)，輸出它被調(diào)用了多少次。

function greet(user) {
  console.count();
  return 'hi ' + user;
}

greet('bob')
//  : 1
// "hi bob"

greet('alice')
//  : 2
// "hi alice"

greet('bob')
//  : 3
// "hi bob"

上面代碼每次調(diào)用greet函數(shù)，內(nèi)部的console.count方法就輸出執(zhí)行次數(shù)。

該方法可以接受一個(gè)字符串作為參數(shù)，作為標(biāo)簽，對(duì)執(zhí)行次數(shù)進(jìn)行分類。

function greet(user) {
  console.count(user);
  return "hi " + user;
}

greet('bob')
// bob: 1
// "hi bob"

greet('alice')
// alice: 1
// "hi alice"

greet('bob')
// bob: 2
// "hi bob"

上面代碼根據(jù)參數(shù)的不同，顯示bob執(zhí)行了兩次，alice執(zhí)行了一次。

dir()，dirxml()

dir方法用來對(duì)一個(gè)對(duì)象進(jìn)行檢查（inspect），并以易于閱讀和打印的格式顯示。

console.log({f1: 'foo', f2: 'bar'})
// Object {f1: "foo", f2: "bar"}

console.dir({f1: 'foo', f2: 'bar'})
// Object
//   f1: "foo"
//   f2: "bar"
//   __proto__: Object

上面代碼顯示dir方法的輸出結(jié)果，比log方法更易讀，信息也更豐富。

該方法對(duì)于輸出DOM對(duì)象非常有用，因?yàn)闀?huì)顯示DOM對(duì)象的所有屬性。

console.dir(document.body)

Node 環(huán)境之中，還可以指定以代碼高亮的形式輸出。

console.dir(obj, {colors: true})

dirxml方法主要用于以目錄樹的形式，顯示DOM節(jié)點(diǎn)。

console.dirxml(document.body)

如果參數(shù)不是DOM節(jié)點(diǎn)，而是普通的JavaScript對(duì)象，console.dirxml等同于console.dir。

console.dirxml([1, 2, 3])
// 等同于
console.dir([1, 2, 3])

assert()

assert方法接受兩個(gè)參數(shù)，第一個(gè)參數(shù)是表達(dá)式，第二個(gè)參數(shù)是字符串。只有當(dāng)?shù)谝粋€(gè)參數(shù)為false，才會(huì)輸出第二個(gè)參數(shù)，否則不會(huì)有任何結(jié)果。

console.assert(true === false, '判斷條件不成立')
// Assertion failed: 判斷條件不成立

下面是另一個(gè)例子，判斷子節(jié)點(diǎn)的個(gè)數(shù)是否大于等于500。

console.assert(list.childNodes.length < 500, '節(jié)點(diǎn)個(gè)數(shù)大于等于500')

上面代碼中，如果符合條件的節(jié)點(diǎn)小于500個(gè)，不會(huì)有任何輸出；只有大于等于500時(shí)，才會(huì)顯示指定文本。

time()，timeEnd()

這兩個(gè)方法用于計(jì)時(shí)，可以算出一個(gè)操作所花費(fèi)的準(zhǔn)確時(shí)間。

console.time('Array initialize');

var array= new Array(1000000);
for (var i = array.length - 1; i >= 0; i--) {
    array[i] = new Object();
};

console.timeEnd('Array initialize');
// Array initialize: 1914.481ms

time方法表示計(jì)時(shí)開始，timeEnd方法表示計(jì)時(shí)結(jié)束。它們的參數(shù)是計(jì)時(shí)器的名稱。調(diào)用timeEnd方法之后，console窗口會(huì)顯示“計(jì)時(shí)器名稱: 所耗費(fèi)的時(shí)間”。

profile()，profileEnd()

console.profile方法用來新建一個(gè)性能測(cè)試器（profile），它的參數(shù)是性能測(cè)試器的名字。

console.profile('p')
// Profile 'p' started.

console.profileEnd方法用來結(jié)束正在運(yùn)行的性能測(cè)試器。

console.profileEnd()
// Profile 'p' finished.

打開瀏覽器的開發(fā)者工具，在profile面板中，可以看到這個(gè)性能調(diào)試器的運(yùn)行結(jié)果。

group()，groupend()，groupCollapsed()

console.group和console.groupend這兩個(gè)方法用于將顯示的信息分組。它只在輸出大量信息時(shí)有用，分在一組的信息，可以用鼠標(biāo)折疊/展開。

console.group('Group One');
console.group('Group Two');

// some code

console.groupEnd(); // Group Two 結(jié)束
console.groupEnd(); // Group One 結(jié)束

console.groupCollapsed方法與console.group方法很類似，唯一的區(qū)別是該組的內(nèi)容，在第一次顯示時(shí)是收起的（collapsed），而不是展開的。

console.groupCollapsed('Fetching Data');

console.log('Request Sent');
console.error('Error: Server not responding (500)');

console.groupEnd();

上面代碼只顯示一行”Fetching Data“，點(diǎn)擊后才會(huì)展開，顯示其中包含的兩行。

trace()，clear()

console.trace方法顯示當(dāng)前執(zhí)行的代碼在堆棧中的調(diào)用路徑。

console.trace()
// console.trace()
//   (anonymous function)
//   InjectedScript._evaluateOn
//   InjectedScript._evaluateAndWrap
//   InjectedScript.evaluate

console.clear方法用于清除當(dāng)前控制臺(tái)的所有輸出，將光標(biāo)回置到第一行。

在控制臺(tái)中，除了使用console對(duì)象，還可以使用一些控制臺(tái)自帶的命令行方法。

（1）$_

$_屬性返回上一個(gè)表達(dá)式的值。

2+2
// 4
$_
// 4

（2）$0 - $4

控制臺(tái)保存了最近5個(gè)在Elements面板選中的DOM元素，$0代表倒數(shù)第一個(gè)，$1代表倒數(shù)第二個(gè)，以此類推直到$4。

（3）$(selector)

$(selector)返回一個(gè)數(shù)組，包括特定的CSS選擇器匹配的所有DOM元素。該方法實(shí)際上是document.querySelectorAll方法的別名。

var images = $('img');
for (each in images) {
  console.log(images[each].src);
}

上面代碼打印出網(wǎng)頁中所有img元素的src屬性。

（4）$$(selector)

$$(selector)返回一個(gè)選中的DOM對(duì)象，等同于document.querySelectorAll。

（5）$x(path)

$x(path)方法返回一個(gè)數(shù)組，包含匹配特定XPath表達(dá)式的所有DOM元素。

$x("http://p[a]")

上面代碼返回所有包含a元素的p元素。

（6）inspect(object)

inspect(object)方法打開相關(guān)面板，并選中相應(yīng)的元素：DOM元素在Elements面板中顯示，JavaScript對(duì)象在Profiles面板中顯示。

（7）getEventListeners(object)

getEventListeners(object)方法返回一個(gè)對(duì)象，該對(duì)象的成員為登記了回調(diào)函數(shù)的各種事件（比如click或keydown），每個(gè)事件對(duì)應(yīng)一個(gè)數(shù)組，數(shù)組的成員為該事件的回調(diào)函數(shù)。

（8）keys(object)，values(object)

keys(object)方法返回一個(gè)數(shù)組，包含特定對(duì)象的所有鍵名。

values(object)方法返回一個(gè)數(shù)組，包含特定對(duì)象的所有鍵值。

var o = {'p1': 'a', 'p2': 'b'};

keys(o)
// ["p1", "p2"]
values(o)
// ["a", "b"]

（9）monitorEvents(object[, events]) ，unmonitorEvents(object[, events])

monitorEvents(object[, events])方法監(jiān)聽特定對(duì)象上發(fā)生的特定事件。當(dāng)這種情況發(fā)生時(shí)，會(huì)返回一個(gè)Event對(duì)象，包含該事件的相關(guān)信息。unmonitorEvents方法用于停止監(jiān)聽。

monitorEvents(window, "resize");
monitorEvents(window, ["resize", "scroll"])

上面代碼分別表示單個(gè)事件和多個(gè)事件的監(jiān)聽方法。

monitorEvents($0, 'mouse');
unmonitorEvents($0, 'mousemove');

上面代碼表示如何停止監(jiān)聽。

monitorEvents允許監(jiān)聽同一大類的事件。所有事件可以分成四個(gè)大類。

• mouse：”mousedown”, “mouseup”, “click”, “dblclick”, “mousemove”, “mouseover”, “mouseout”, “mousewheel”
• key：”keydown”, “keyup”, “keypress”, “textInput”
• touch：”touchstart”, “touchmove”, “touchend”, “touchcancel”
• control：”resize”, “scroll”, “zoom”, “focus”, “blur”, “select”, “change”, “submit”, “reset”

monitorEvents($("#msg"), "key");

上面代碼表示監(jiān)聽所有key大類的事件。

（10）profile([name])，profileEnd()

profile方法用于啟動(dòng)一個(gè)特定名稱的CPU性能測(cè)試，profileEnd方法用于結(jié)束該性能測(cè)試。

profile('My profile')
profileEnd('My profile')

（11）其他方法

命令行API還提供以下方法。

• clear()：清除控制臺(tái)的歷史。
• copy(object)：復(fù)制特定DOM元素到剪貼板。
• dir(object)：顯示特定對(duì)象的所有屬性，是console.dir方法的別名。
• dirxml(object)：顯示特定對(duì)象的XML形式，是console.dirxml方法的別名。

debugger語句主要用于除錯(cuò)，作用是設(shè)置斷點(diǎn)。如果有正在運(yùn)行的除錯(cuò)工具，程序運(yùn)行到debugger語句時(shí)會(huì)自動(dòng)停下。如果沒有除錯(cuò)工具，debugger語句不會(huì)產(chǎn)生任何結(jié)果，JavaScript引擎自動(dòng)跳過這一句。

在Chrome瀏覽器中，當(dāng)代碼運(yùn)行到debugger語句時(shí)，就會(huì)暫停運(yùn)行，自動(dòng)打開控制臺(tái)界面。

for(var i = 0; i < 5; i++){
  console.log(i);
  if (i === 2) debugger;
}

上面代碼打印出0，1，2以后，就會(huì)暫停，自動(dòng)打開控制臺(tái)，等待進(jìn)一步處理。

• Chrome Developer Tools, Using the Console
• Matt West, Mastering The Developer Tools Console
• Firebug Wiki, Console API
• Axel Rauschmayer, The JavaScript console API
• Marius Schulz, Advanced JavaScript Debugging with console.table()
• Google Developer, Command Line API Reference