[译] 如何充分利用 JavaScript 控制台-CSDN博客

原文地址：How to get the most out of the JavaScript console
原文作者：Darryl Pargeter
译文出自：掘金翻译计划
译者：sunui
校对者：reid3290、Aladdin-ADD

JavaScript 中最基本的调试工具之一就是 console.log()。console 还附带了一些其他好用的方法，可以添加到开发人员的调试工具包中。

你可以使用 console 执行以下任务：

输出一个计时器来协助进行简单的基准测试
输出一个表格来以易读的格式显示一个数组或对象
使用 CSS 将颜色和其他样式选项应用于输出

Console 对象

console 对象允许您访问浏览器的控制台。它允许你输出有助于调试代码的字符串、数组和对象。console 是 window 对象的属性，由浏览器对象模型(BOM)提供。

我们可以通过这两种方法之一访问 console：

window.console.log('This works')
console.log('So does this')

第二个选项本质上是对前者的引用，所以我们使用后者以精简代码。

关于 BOM 的快速提示：它没有设定标准，所以每家浏览器都以稍微不同的方式实现。我在 Chrome 和 Firefox 测试了所有示例，但你的输出可能有所不同，这取决于你使用的浏览器。

输出文本

将文本记录到控制台
console 对象最常见的元素是 console.log，对于大多数情况，使用它就可以完成任务。

输出信息到控制台的四种方式：

log
info
warn
error

他们四个工作方式相同。你唯一要做的是给选择的方法传递一个或更多的参数。控制台会显示不同的图标来指示其记录级别。下面的例子中你可以看到 info 级别的记录和 warning/error 级别的不同之处。

简单易读的输出

输出东西太多将变得难以阅读

你可能注意到了 error 日志消息 —— 它比其他消息更显眼。它显示着红色的背景和堆栈跟踪，而 info 和 warn 就不会。但是在 Chrome 中 warn 确实有一个黄色的背景。

视觉上的区分有助于你在控制台快速浏览辨别出错误或警告信息。你应该确保在准备生产的应用中移除它们，除非你打算让它们来警示其他操作你的代码的开发者。

字符串替换

这个技术可以使用字符串中的占位符来替换你向方法中传入的其他参数。

输入： console.log('string %s', 'substitutions')

输出： string substitutions

%s 是逗号后面第二个参数 'substitutions' 的占位符。任何的字符串、整数或数组都将被转换成字符串并替换 %s。如果你传入一个对象，它将显示为 [object Object]。

如果你想传入对象，你需要使用 %o 或者 %O，而不是 %s。

console.log('this is an object %o', { obj: { obj2: 'hello' }})

数字

字符串替换可以与整数和浮点数一起使用：

整数使用 %i 或 %d,
浮点数使用 %f。

输入： console.log('int: %d, floating-point: %f', 1, 1.5)

输出：int: 1, floating-point: 1.500000

可以使用 %.1f 来格式化浮点数，使小数点后仅显示一位小数。你可以用 %.nf 来显示小数点后 n 位小数。

如果我们使用上述例子显示小数点后一位小数来格式化浮点数值，它看起来这样：

输入： console.log('int: %d, floating-point: %.1f', 1, 1.5)

输出： int: 1, floating-point: 1.5

格式化说明符

%s | 使用字符串替换元素
%(d|i)| 使用整数替换元素
%f| 使用浮点数替换元素
%(o|O) | 元素显示为一个对象
%c | 应用提供的 CSS

字符串模板

随着 ES6 的出现，模板字符串是替换或连接的替代品。他们使用反引号(``)来代替引号，变量包裹在 ${} 中：

const a = 'substitutions';

console.log(`bear: ${a}`);

// bear: substitutions复制代码

对象在模板字符串中显示为 [object Object]，所以你将需要使用 %o 或 %O 替换以看到详情，或单独记录。

比起使用字符串连接：console.log('hello' + str + '!');，使用替换或模板可以创建更易读的代码。

美妙的彩色插曲！

现在，是时候来点更有趣而多彩的东西了！

是时候用字符串替换让我们的 console 弹出丰富多彩的颜色了。

我将使用一个模仿 Ajax 的例子，给我们显示一个请求成功（用绿色）和失败（用红色）。这是输出和代码：

成功的小熊和失败的蝙蝠

const success = [
 'background: green',
 'color: white',
 'display: block',
 'text-align: center'
].join(';');

const failure = [
 'background: red',
 'color: white',
 'display: block',
 'text-align: center'
].join(';');

console.info('%c /dancing/bears was Successful!', success);
console.log({data: {
 name: 'Bob',
 age: 'unknown'
}}); // "mocked" data response

console.error('%c /dancing/bats failed!', failure);
console.log('/dancing/bats Does not exist');复制代码

在字符串替换中使用 %c 占位符来应用你的样式规则。

console.error('%c /dancing/bats failed!', failure);复制代码

然后把你的 CSS 元素作为参数，你就能看到应用 CSS 的日志了。你也可以给你的字符串添加多个 %c。

console.log('%cred %cblue %cwhite','color:red;','color:blue;', 'color: white;')复制代码

这将按照他们的代表的颜色输出字符 “red”、“blue” 和 “white”。

控制台仅仅支持少数 CSS 属性，建议你试验一下哪些支持哪些不支持。重申一下，你的输出结果可能因你的浏览器而异。

其他可用的方法

还有几个其他可用的 console 方法。注意下面有几项还不是 API 标准，所以可能浏览器间互不兼容。这个例子使用的是 Firefox 51.0.1。

Assert()

Assert 携带两个参数 —— 如果第一个参数计算为 false，那么它将显示第二个参数。

let isTrue = false;

console.assert(isTrue, 'This will display');

isTrue = true;

console.assert(isTrue, 'This will not');复制代码

如果断言为 false，控制台将输出内容。它显示为一个上文提到的 error 级别的日志，给你显示一个红色的错误消息和堆栈跟踪。

Dir()

dir 方法显示一个传入对象的可交互属性列表。

console.dir(document.body);复制代码

Chrome 会显示不同的层级
最终，dir 仅仅能节省一两次点击，如果你需要检查一个 API 响应返回的对象，你可以用它结构化地显示出来以节约一些时间。

Table()

table 方法用一个表格显示数组或对象

console.table(['Javascript', 'PHP', 'Perl', 'C++']);复制代码

输出数组

数组的索引或对象的属性名位于左侧的索引栏，值显示在右侧列栏。

const superhero = {
    firstname: 'Peter',
    lastname: 'Parker',
}
console.table(superhero);复制代码

输出对象

Chrome 用户需要注意： 这是我的同事提醒我的，上述 table 方法的例子在 Chrome 中貌似不能工作。你可以通过将项目放入数组或对象数组中来解决此问题。

console.table([['Javascript', 'PHP', 'Perl', 'C++']]);

const superhero = {
    firstname: 'Peter',
    lastname: 'Parker',
}
console.table([superhero]);复制代码

Group()

console.group() 由至少三个 console 调用组成，它可能是使用时需要打最多字的方法。但它也是最有用的方法之一（特别对使用 Redux Logger 的开发者）。

稍基础的调用看起来是这样的：

console.group();
console.log('I will output');
console.group();
console.log('more indents')
console.groupEnd();
console.log('ohh look a bear');
console.groupEnd();复制代码

这将输出多个层级，显示效果因你的显示器而异。

Firefox 显示成缩进列表：

Chrome 显示成对象的风格：

每次调用 console.group() 都将开启一个新的组，如果在一个组内会创建一个新的层级。每次调用 console.groupEnd() 都会结束当前组或层级并向上移动一个层级。

我发现 Chrome 的输出样式更易读，因为它看起来像一个可折叠的对象。

你可以给 group 传入一个 header 参数，它将被显示并替代 console.group：