console

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

备注: 此特性在 Web Worker 中可用。

console 对象提供了浏览器控制台调试的接口(如:Firefox 的 Web console)。在不同浏览器上它的工作方式可能不一样,但通常都会提供一套共性的功能。

console 对象可以从任何全局对象中访问到,如 浏览器作用域上的 Window,以及通过属性控制台作为 worker 中的特定变体的 WorkerGlobalScope。可以通过 Window.console 引用,也可以简单的通过 console 引用。例:

js
console.log("Failed to open the specified link");

实例方法

console.assert()

如果第一个参数为 false,则将消息和堆栈跟踪记录到控制台。

console.clear()

清空控制台。

console.count()

以参数为标识记录调用的次数,调用时在控制台打印标识以及调用次数。

console.countReset()

重置指定标签的计数器值。

console.debug()

在控制台打印一条 "debug" 级别的消息。

console.dir()

显示一个由特定的 Javascript 对象列表组成的可交互列表。这个列表可以使用三角形隐藏和显示来审查子对象的内容。

console.dirxml()

打印 XML/HTML 元素表示的指定对象,否则显示 JavaScript 对象视图。

console.error()

打印一条错误信息,使用方法可以参考使用字符串替换

console.exception() 非标准 已弃用

error() 方法的别称。

console.group()

创建一个新的内联分组, 后续所有打印内容将会以子层级的形式展示。调用 groupEnd()来闭合组。

console.groupCollapsed()

创建一个新的内联分组。使用方法和 group() 相同,不同的是,groupCollapsed() 方法打印出来的内容默认是折叠的。调用groupEnd()来闭合组。

console.groupEnd()

闭合当前内联分组

console.info()

打印资讯类说明信息,使用方法可以参考使用字符串替换

console.log()

打印内容的通用方法,使用方法可以参考使用字符串替换

console.profile() 非标准

Starts the browser's built-in profiler (for example, the Firefox performance tool). You can specify an optional name for the profile.

console.profileEnd() 非标准

Stops the profiler. You can see the resulting profile in the browser's performance tool (for example, the Firefox performance tool).

console.table()

将列表型的数据打印成表格。

console.time()

启动一个以入参作为特定名称的定时器,在显示页面中可同时运行的定时器上限为 10,000.

console.timeEnd()

结束特定的定时器并以毫秒打印其从开始到结束所用的时间。

console.timeLog()

打印特定定时器所运行的时间。

console.timeStamp() 非标准

添加一个标记到浏览器的 TimelineWaterfall 工具。

console.trace()

输出堆栈跟踪

console.warn()

打印一个警告信息,可以使用字符串替换和额外的参数。

示例

输出文本到控制台

console 对象中较多使用的主要有四个方法 console.log()console.info()console.warn()console.error()。每一个结果在日志中都有不同的样式,可以使用浏览器控制台的日志筛选功能筛选出感兴趣的日志信息。

有两种途径使用这些方法,可以简单的传入一组对象,其中的字符串对象会被连接到一起,输出到控制台。或者可以传入包含零个或多个的替换的字符串,后面跟着被替换的对象列表。

打印单个对象

使用日志记录方法的最简单方式是输出单个对象:

js
const someObject = { str: "一些文本", id: 5 };
console.log(someObject);

打印结果类似下面:

{str:"一些文本", id:5}

打印多个对象

可以打印多个对象,就像下面一样:

js
const car = "道奇战马";
const someObject = { str: "一些文本", id: 5 };
console.info("我的第一辆车是", car, "。该对象为:", someObject);

打印结果类似下面:

我的第一辆车是 道奇战马。该对象为: {str:"一些文本", id:5}

使用字符串替换

可以在传递给 console 的方法的时候使用下面的字符以期进行参数的替换。

Substitution string Description
%o or %O 打印 JavaScript 对象。在审阅器点击对象名字可展开更多对象的信息。
%d or %i 打印整数。支持数字格式化。例如,console.log("Foo %.2d", 1.1) 会输出有先导 0 的两位有效数字:Foo 01
%s 打印字符串。
%f 打印浮点数。支持格式化,比如 console.log("Foo %.2f", 1.1) 会输出两位小数:Foo 1.10

备注: Chrome 不支持精确格式化。

当要替换的参数类型和预期的打印类型不同时,参数会被转换成预期的打印类型。

js
for (let i = 0; i < 5; i++) {
  console.log("你好,%s。你已经联系我 %d 次了。", "小明", i + 1);
}

输出样例如下所示:

你好,小明。你已经联系我 1 次了。
你好,小明。你已经联系我 2 次了。
你好,小明。你已经联系我 3 次了。
你好,小明。你已经联系我 4 次了。
你好,小明。你已经联系我 5 次了。

为控制台定义样式

可以使用 %c 为打印内容定义样式:

js
console.log(
  "This is %cMy stylish message",
  "color: yellow; font-style: italic; background-color: blue;padding: 2px",
);

指令前的文本不会受到影响,但指令后的文本将会使用参数中声明的 CSS 样式。

Firefox 控制台中添加了样式的文本

%c 语法可用的属性如下 (至少在 Firefox 中是这样,别的浏览器会有诸多不同):

备注: 控制台信息的默认行为与行内元素相似。为了应用 paddingmargin 这类效果,你应当将 display 属性设置为 display: inline-block

在 console 中使用编组

可以使用嵌套组来把视觉上相关的元素合并,以协助组织你的输出。使用console.group()创建新的嵌套块,或者用console.groupCollapsed() 创建默认折叠的块,这种块需要点击闭合按钮来展开才能读到。

直接调用 console.groupEnd().就可以退出当前组。比如下面的代码:

js
console.log("This is the outer level");
console.group();
console.log("Level 2");
console.group();
console.log("Level 3");
console.warn("More of level 3");
console.groupEnd();
console.log("Back to level 2");
console.groupEnd();
console.debug("Back to the outer level");

执行结果:

Firefox 控制台中的嵌套编组演示

计时器

你可以使用计时器来计算一段特定操作的周期。使用 console.time() 方法以创建一个计时器,其唯一的参数表示了计时器的名字。使用 console.timeEnd() 方法以关闭计时器,并获取经过的毫秒数,其同样以计时器的名字作为参数。一个页面最多同时只能有 10000 个计数器运行。

示例::

js
console.time("answer time");
alert("Click to continue");
console.timeLog("answer time");
alert("Do a bunch of other stuff...");
console.timeEnd("answer time");

这段代码将会打印需要用户关闭 alert box 的时间,打印时间到控制台上,等用户关闭第二个 alert 后,把结束时间打印到控制台。

Firefox 控制台的时间记录

注意无论在开始还是结束的时候都会打印计时器的名字。

备注: 如果使用计时器来记录网络时间请求的话下面的内容很重要。计时器将会报告传输过程的整个时间,而网络面板里显示的时间只计算了请求头部所需要的时间。如果启用了响应体日志记录,那么列出的响应头部和响应体组合的时间应该与在控制台输出中看到的时间相符。

堆栈跟踪

控制台也支持输出堆栈,其将会显示到调用 console.trace_static 的点的调用路径。如下所示:

js
function foo() {
  function bar() {
    console.trace();
  }
  bar();
}

foo();

控制台的输出:

Firefox 控制台的堆栈跟踪

规范

Specification
Console Standard
# console-namespace

浏览器兼容性

BCD tables only load in the browser

参见