console对象


console对象代表浏览器的JavaScript控制台。虽然它还不是标准,但是各大浏览器都原生支持,已经成为事实上的标准。

console对象主要有两个作用:

  • 显示网页代码运行时的错误信息。
  • 提供了一个命令行接口,用来与网页代码互动。

console对象的接口有很多方法,可供开发者调用。

console.log()

log方法用于在console窗口显示信息。

如果参数是普通字符串,log方法将字符串内容显示在console窗口。



console.log("Hello World") // Hello World console.log("a","b","c") // a b c



如果参数是格式字符串(使用了格式占位符),log方法将占位符替换以后的内容,显示在console窗口。



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



上面代码的%s表示字符串的占位符,其他占位符还有

  • %d, %i 整数
  • %f 浮点数
  • %o 对象的链接
  • %c CSS格式字符串

log方法的两种参数格式,可以结合在一起使用。



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



console对象的所有方法,都可以被覆盖。因此,可以按照自己的需要,定义console.log方法。



["log", "warn", "error"].forEach(function(method) { console[method] = console[method].bind( console, new Date().toISOString() ); }); console.log("出错了!"); // 2014-05-18T09:00.000Z 出错了!



上面代码表示,使用自定义的console.log方法,可以在显示结果添加当前时间。

console.debug(),console.info(),console.warn(),console.error()

除了log,console对象还有四个输出信息的方法:

  • debug:等同于log。
  • info:等同于log。
  • warn:输出信息时,在最前面加一个黄色三角,表示警告。
  • error:输出信息时,在最前面加一个红色的叉,表示出错。

这四个方法的用法与log完全一样。



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)



console.table()

对于某些复合类型的数据,console.table方法可以将其转为表格显示。



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



上面代码的language,转为表格显示如下。

(index)

name

fileExtension

0

"JavaScript"

".js"

1

"TypeScript"

".ts"

2

"CoffeeScript"

".coffee"

复合型数据转为表格显示的条件是,必须拥有主键。对于上面的数组来说,主键就是数字键。对于对象来说,主键就是它的最外层键。



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



上面代码的language,转为表格显示如下。

(index)

name

paradigm

csharp

"C#"

"object-oriented"

fsharp

"F#"

"functional"

console.assert()

assert方法用来验证某个条件是否为真。如果为假,则显示一条事先指定的错误信息。它的格式如下。



console.assert(条件判断,输出信息)



使用方法如下。



console.assert(true === false,"判断条件不成立") // Assertion failed: 判断条件不成立



下面是另一个例子,判断子节点的个数是否大于等于500。



console.assert(list.childNodes.length < 500, "节点个数大于等于500")



console.time(),console.timeEnd()

这两个方法用于计时,可以算出一个操作所花费的准确时间。



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方法表示计时开始,timeEnd方法表示计时结束。它们的参数是计时器的名称。调用timeEnd方法之后,console窗口会显示“计时器名称: 所耗费的时间”。

console.group(),console.groupend()

这两个方法用于将显示的信息分组。它只在输出大量信息时有用,分在一组的信息,可以用鼠标折叠/展开。

其他方法

  • console.dir():输出对象的信息,用于显示一个对象的所有属性。
  • console.clear():对console窗口进行清屏,光标回到第一行。
  • console.trace():当前执行的代码在堆栈中的调用路径。

命令行API



在控制台中,除了使用console对象,还可以使用一些控制台自带的命令行方法。

**(1)$_ **

$_属性返回上一个表达式的值。



2+2
// 4
$_ // 4



**(2)$0 - $4 **

控制台保存了最近5个在Elements面板选中的DOM元素,$0代表倒数第一个,$1代表倒数第二个,以此类推直到$4。

**(3)$(selector) **

$(selector)返回一个数组,包括特定的CSS选择器匹配的所有DOM元素。该方法实际上是document.querySelectorAll方法的别名。



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



上面代码打印出网页中所有img元素的src属性。

**(4)$x(path) **

$x(path)方法返回一个数组,包含匹配特定XPath表达式的所有DOM元素。



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



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

**(5)inspect(object) **

inspect(object)方法打开相关面板,并选中相应的元素:DOM元素在Elements面板中显示,JavaScript对象在Profiles中显示。

**(6)getEventListeners(object) **

getEventListeners(object)方法返回一个对象,该对象的成员为登记了回调函数的各种事件(比如click或keydown),每个事件对应一个数组,数组的成员为该事件的回调函数。

**(7)keys(object),values(object) **

keys(object)方法返回一个数组,包含特定对象的所有键名。

values(object)方法返回一个数组,包含特定对象的所有键值。



var o = {'p1':'a', 'p2':'b'}; keys(o) // ["p1", "p2"] values(o) // ["a", "b"]



(8)monitorEvents(object[, events]) ,unmonitorEvents(object[, events])

monitorEvents(object[, events])方法监听特定对象上发生的特定事件。当这种情况发生时,会返回一个Event对象,包含该事件的相关信息。unmonitorEvents方法用于停止监听。



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



上面代码分别表示单个事件和多个事件的监听方法。



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



上面代码表示如何停止监听。

monitorEvents允许监听同一大类的事件。所有事件可以分成四个大类。

  • 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");



上面代码表示监听所有key大类的事件。

**(9)profile([name]),profileEnd() **

profile方法用于启动一个特定名称的CPU性能测试,profileEnd方法用于结束该性能测试。



profile("My profile")

profileEnd("My profile")



**(10)其他方法 **

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

  • clear()方法清除控制台的历史。
  • copy(object)方法复制特定DOM元素到剪贴板。
  • dir(object)方法显示特定对象的所有属性,是console.dir方法的别名。
  • dirxml(object)方法显示特定对象的XML形式,是console.dirxml方法的别名。

debugger语句



debugger语句必须与除错工具配合使用,如果没有除错工具,debugger语句不会产生任何结果。

在chrome浏览器中,当代码运行到debugger指定的行时,就会暂停运行,自动打开console界面。它的作用类似于设置断点。



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



上面代码打印出0,1,2以后,就会暂停,自动打开console窗口,等待进一步处理。