Console API - 提供了允许开发人员执行调试任务的功能
Console API 提供了允许开发人员执行调试任务的功能,如记录消息或代码中设定点的变量值,或为一个操作完成所需的时间计时。
注意: 此特性在 Web Worker 中可用。
概念和用法
Console API 在很大程度上是一个专有的 API,不同的浏览器以不一致的方式实现它。The Console API 规范是为了定义一致的行为而创建的,所有现代浏览器最终都实现了这一行为 -- 尽管一些实现仍有自己的附加专有功能。请在以下网址了解这些功能。
使用非常简单 -- console
对象由 window.console
或在工作线程中由 WorkerGlobalScope.console
提供;只需使用 console
即可访问,它包含许多方法,您可以调用这些方法来执行基本的调试任务,通常集中在将各种值记录到浏览器的 Web 控制台。
到目前为止,最常用的方法是 console.log
,该方法用于记录特定变量中包含的当前值。
接口
console
提供基本的调试功能,包括日志记录,堆栈跟踪,计时器和计数器。
Examples
let myString = 'Hello world';
// 在控制台输出 “Hello world”
console.log(myString)
有关更多实例,请参见控制台参考页。
规范
规范 | 状态 | 备注 |
---|---|---|
Console API | 现行的标准 | 初始定义。 |
桌面浏览器兼容性
特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
基础支持 | 1 | 12 | 2 | 81 | 10.5 | 3 |
assert | 1 | 12 | 28 | 8 | 11 | 4 |
clear | 25 | 12 | 39 | 8 | 12 | 6.1 |
count | 1 | 12 | 30 | 11 | 11 | 4 |
countReset | 68 | 79 | 62 | 不支持 | 55 | 13 |
debug | 1 | 12 | 4 | 10 | 11 | 4 |
dir | 1 | 12 | 8 | 9 | 11 | 4 |
dirxml | 1 | 12 | 39 | 11 | 11 | 4 |
error | 1 | 12 | 4 | 8 | 10.5 | 3 |
exception (an alias for error ) | 不支持 | 13 — 79 | 28 | 不支持 | 不支持 | 不支持 |
group | 1 | 12 | 4 | 11 | 11 | 4 |
groupCollapsed | 6 | 12 | 9 | 11 | 11 | 5.1 |
groupEnd | 1 | 12 | 9 | 11 | 11 | 4 |
info | 1 | 12 | 4 | 8 | 10.5 | 3 |
log | 1 | 12 | 4 | 8 | 10.5 | 3 |
profile | 4 | 12 | 16 | 9 | 11 | 4 |
profileEnd | 4 | 12 | 16 | 9 | 11 | 4 |
table | 27 | 13 | 34 | 不支持 | 11 | 6.1 |
time | 1 | 12 | 10 | 11 | 11 | 4 |
timeEnd | 1 | 12 | 10 | 11 | 11 | 4 |
timeLog | 71 | 79 | 62 | 不支持 | 60 | 13 |
timeStamp | 14 | 12 | 39 | 11 | 15 | 6 |
trace | 1 | 12 | 10 | 11 | 11 | 4 |
warn | 1 | 12 | 4 | 8 | 10.5 | 3 |
在 Worker 中可用 | 支持 | 12 | 38 | 支持 | 支持 | 支持 |
移动浏览器兼容性
特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
基础支持 | 1 | 18 | 未知 | 4 | 未知 | 11 | 1 |
assert | 1 | 18 | 未知 | 28 | 未知 | 11 | 3.2 |
clear | ≤37 | 25 | 未知 | 39 | 未知 | 12 | 7 |
count | 1 | 18 | 未知 | 30 | 未知 | 11 | 3.2 |
countReset | 68 | 68 | 未知 | 62 | 未知 | 48 | 13 |
debug | 1 | 18 | 未知 | 4 | 未知 | 11 | 3.2 |
dir | 1 | 18 | 未知 | 8 | 未知 | 11 | 3.2 |
dirxml | 1 | 18 | 未知 | 39 | 未知 | 11 | 3.2 |
error | 1 | 18 | 未知 | 4 | 未知 | 11 | 1 |
exception (an alias for error ) | 不支持 | 不支持 | 未知 | 28 | 未知 | 未知 | 不支持 |
group | 37 | 18 | 未知 | 4 | 未知 | 11 | 3.2 |
groupCollapsed | 37 | 18 | 未知 | 9 | 未知 | 11 | 5.1 |
groupEnd | 37 | 18 | 未知 | 9 | 未知 | 11 | 3.2 |
info | 1 | 18 | 未知 | 4 | 未知 | 11 | 1 |
log | 1 | 18 | 未知 | 4 | 未知 | 11 | 1 |
profile | ≤37 | 18 | 未知 | 16 | 未知 | 11 | 3.2 |
profileEnd | ≤37 | 18 | 未知 | 16 | 未知 | 11 | 3.2 |
table | ≤37 | 27 | 未知 | 34 | 未知 | 11 | 7 |
time | 1 | 18 | 未知 | 10 | 未知 | 11 | 3.2 |
timeEnd | 1 | 18 | 未知 | 10 | 未知 | 11 | 3.2 |
timeLog | 71 | 71 | 未知 | 62 | 未知 | 50 | 13 |
timeStamp | ≤37 | 18 | 未知 | 39 | 未知 | 14 | 6 |
trace | 1 | 18 | 未知 | 10 | 未知 | 11 | 3.2 |
warn | 1 | 18 | 未知 | 4 | 未知 | 11 | 1 |
在 Worker 中可用 | 支持 | 支持 | 未知 | 38 | 未知 | 未知 | 未知 |
1. 在 Internet Explorer 8 和 9 中,当未打开开发人员工具时,console
对象是 undefined
。此行为已在 Internet Explorer 10 中修复。
2. 断言失败时抛出错误。
3. console.log
的别名
4. 不使用 Logger 记录数据。
5. console.group
的别名
6. console.error
的别名