[翻译]Chrome控制台API参考

控制台API为web应用程序提供了一些方法，包括输出信息到控制台、创建JavaScript profiles、启动调试会话等。

console.assert(expression, object)

如果expression表达式为false，object指定的信息就会和调试追踪信息一起输出到控制台。在下面的例子中，当被选择节点的子元素数量小于5时，assert中的object信息就会被输出。

console.clear()

清空控制台上所有信息。

然而，如果Preserve Log选项是开启的，那console.clear()不会清空当前控制台的信息。但是在右键菜单里的‘Clear Console’仍然是可以清空输出信息的。

console.count(label)

将count()方法被调用的次数输出到控制台。

下面的例子中，每次调用login函数count()就会在控制台输出信息。count方法很适合用来统计函数的调用次数。

当然，如果count方法传入的label标识不一样，那它们将会被单独统计。

console.debug(object[, object, ...])

这个方法和console.log()作用是相同的。

console.dir(object)

将object以JavaScript对象的形式输出在控制台。如果object是HTML元素，那么它会以如下形式输出：

当然，使用console.log()方法也能达到同样的效果，只要第一个参数中包含‘%o’标识符就可以了。

如果对JavaScript对象调用console.dir()，与调用console.log()效果是相同的，以树状形式将对象属性输出。

console.log()方法显示HTML元素时，就是以XML的格式输出，就像是在Elements面板中一样。

console.dirxml(object)

将对象以XML的表现形式输出，如果object是HTML元素，那么输出结果就与在Elements面板中的表现形式一样。

console.error(object[, object, ...])

这个方法的作用与console.log()差不多，只是包含了这个方法调用的追踪信息。

console.group(object[, object, ...])

开启一个新的信息输出组，可以传入一个可选的组标题。在console.group()和console.groupEnd()方法之间的所有控制台输出都会在同一个组里。

也可以进行组嵌套：

 

console.groupCollapsed(object[, object, ..])

创建一个新的控制台输出组，与console.group()不同的是，这个输出组的信息默认是折叠的。

console.groupEnd()

关闭最近一个由console.group()或者console.groupCollapsed()创建的输出组。

console.info(object[, object, ...])

这个方法的输出效果与console.log()相同。

console.log(object[, object, ...])

这个方法主要用来在控制台输出信息。可以传递一个或者多个参数，参数之间由空格连接输出。第一个参数可以包含‘格式化字符’（由%和表示格式的字符组成的标记）。

 

console.log()

下面是一个使用%s和%d格式说明符格式化显示字符串的例子：

下面是使用%o(格式说明符)和%O(格式说明符)格式化显示DOM元素的例子：

而下面就是使用%c格式说明符来着色输出字符串：

console.time(label)

启动一个以label标识的新计时器。当console.timeEnd()被调用且传入同样的label后，这个计时器会停止并在控制台输出经过的时间。计时器的值是精确到亚毫秒的。

注意：传递给console.time()和console.timeEnd()方法的label必须是相同的，才能结束这个定时器。

console.warn(object[,object,...])

这个方法与console.log()效果相似，只是在输出信息前会添加一个黄色的警告图标。