From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/zh-cn/web/api/console/assert/index.html | 102 +++++++ files/zh-cn/web/api/console/clear/index.html | 110 ++++++++ files/zh-cn/web/api/console/count/index.html | 169 ++++++++++++ files/zh-cn/web/api/console/countreset/index.html | 132 +++++++++ files/zh-cn/web/api/console/debug/index.html | 67 +++++ files/zh-cn/web/api/console/dir/index.html | 106 +++++++ files/zh-cn/web/api/console/dirxml/index.html | 98 +++++++ files/zh-cn/web/api/console/error/index.html | 170 ++++++++++++ files/zh-cn/web/api/console/group/index.html | 68 +++++ .../web/api/console/groupcollapsed/index.html | 70 +++++ files/zh-cn/web/api/console/groupend/index.html | 118 ++++++++ files/zh-cn/web/api/console/index.html | 303 +++++++++++++++++++++ files/zh-cn/web/api/console/info/index.html | 155 +++++++++++ files/zh-cn/web/api/console/log/index.html | 124 +++++++++ files/zh-cn/web/api/console/profile/index.html | 114 ++++++++ files/zh-cn/web/api/console/profileend/index.html | 46 ++++ files/zh-cn/web/api/console/table/index.html | 151 ++++++++++ files/zh-cn/web/api/console/time/index.html | 55 ++++ files/zh-cn/web/api/console/timeend/index.html | 61 +++++ files/zh-cn/web/api/console/timelog/index.html | 102 +++++++ files/zh-cn/web/api/console/timestamp/index.html | 98 +++++++ files/zh-cn/web/api/console/trace/index.html | 70 +++++ files/zh-cn/web/api/console/warn/index.html | 147 ++++++++++ 23 files changed, 2636 insertions(+) create mode 100644 files/zh-cn/web/api/console/assert/index.html create mode 100644 files/zh-cn/web/api/console/clear/index.html create mode 100644 files/zh-cn/web/api/console/count/index.html create mode 100644 files/zh-cn/web/api/console/countreset/index.html create mode 100644 files/zh-cn/web/api/console/debug/index.html create mode 100644 files/zh-cn/web/api/console/dir/index.html create mode 100644 files/zh-cn/web/api/console/dirxml/index.html create mode 100644 files/zh-cn/web/api/console/error/index.html create mode 100644 files/zh-cn/web/api/console/group/index.html create mode 100644 files/zh-cn/web/api/console/groupcollapsed/index.html create mode 100644 files/zh-cn/web/api/console/groupend/index.html create mode 100644 files/zh-cn/web/api/console/index.html create mode 100644 files/zh-cn/web/api/console/info/index.html create mode 100644 files/zh-cn/web/api/console/log/index.html create mode 100644 files/zh-cn/web/api/console/profile/index.html create mode 100644 files/zh-cn/web/api/console/profileend/index.html create mode 100644 files/zh-cn/web/api/console/table/index.html create mode 100644 files/zh-cn/web/api/console/time/index.html create mode 100644 files/zh-cn/web/api/console/timeend/index.html create mode 100644 files/zh-cn/web/api/console/timelog/index.html create mode 100644 files/zh-cn/web/api/console/timestamp/index.html create mode 100644 files/zh-cn/web/api/console/trace/index.html create mode 100644 files/zh-cn/web/api/console/warn/index.html (limited to 'files/zh-cn/web/api/console') diff --git a/files/zh-cn/web/api/console/assert/index.html b/files/zh-cn/web/api/console/assert/index.html new file mode 100644 index 0000000000..4ce50bbef2 --- /dev/null +++ b/files/zh-cn/web/api/console/assert/index.html @@ -0,0 +1,102 @@ +--- +title: Console.assert() +slug: Web/API/Console/assert +tags: + - console +translation_of: Web/API/console/assert +--- +
{{APIRef("Console API")}}
+ +

如果断言为false，则将一个错误消息写入控制台。如果断言是 true，没有任何反应。

+ +

{{AvailableInWorkers}}

+ +
+

console.assert()方法在Node.js中的实现和浏览器中可用的console.assert()方法实现是不同的。在浏览器中当console.assert()方法接受到一个值为假断言的时候，会向控制台输出传入的内容，但是并不会中断代码的执行，而在Node.js v10.0.0之前，一个值为假的断言也将会导致一个AssertionError被抛出，使得代码执行被打断。v10.0.0修复了此差异，所以现在console.assert()在Node 和浏览器中执行行为相同 。

+
+ +

语法

+ +
console.assert(assertion, obj1 [, obj2, ..., objN]);
+console.assert(assertion, msg [, subst1, ..., substN]); // c-like message formatting
+ +

参数

+ +
+
assertion
+
一个布尔表达式。如果assertion为假，消息将会被输出到控制台之中。
+
obj1 ... objN
+
被用来输出的Javascript对象列表，最后输出的字符串是各个对象依次拼接的结果。
+
msg
+
一个包含零个或多个子串的Javascript字符串。
+
subst1 ... substN
+
各个消息作为字串的Javascript对象。这个参数可以让你能够控制输出的格式。
+
+ +

案例

+ +

下面的代码示例演示了JavaScript对象的使用:

+ +
const errorMsg = 'the # is not even';
+for (let number = 2; number <= 5; number += 1) {
+    console.log('the # is ' + number);
+    console.assert(number % 2 === 0, {number: number, errorMsg: errorMsg});
+    // 或者使用 ES2015 对象简写:
+    // console.assert(number % 2 === 0, {number, errorMsg});
+}
+// 输出:
+// the # is 2
+// the # is 3
+// Assertion failed: {number: 3, errorMsg: "the # is not even"}
+// the # is 4
+// the # is 5
+// Assertion failed: {number: 5, errorMsg: "the # is not even"}
+ +

请注意, 你可以在大多数浏览器中使用 console.log 进行格式化输出

+ +
console.log('the word is %s try number %d', 'foo', 123);
+// 输出: the word is foo try number 123
+ +

但是 console.assert 在不同浏览器中可能获得不同的效果:

+ +
console.assert(false, 'the word is %s', 'foo');
+// correct output in Node (e.g. v8.10.0) and some browsers
+//     (e.g. Firefox v60.0.2):
+// Assertion failed: the word is foo
+// incorrect output in some browsers
+//     (e.g. Chrome v67.0.3396.87):
+// Assertion failed: the word is %s foo
+ +

有关详细信息，请参阅 {{Domxref("console")}} 文档中的 输出文本到控制台。

+ +

规范

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#consoleassertexpression-object", "console.assert()")}}{{Spec2("Console API")}}Initial definition
+ +

浏览器兼容性

+ +

{{Compat("api.Console.assert")}}

+ +

相关链接

+ + diff --git a/files/zh-cn/web/api/console/clear/index.html b/files/zh-cn/web/api/console/clear/index.html new file mode 100644 index 0000000000..4de2fcb2ea --- /dev/null +++ b/files/zh-cn/web/api/console/clear/index.html @@ -0,0 +1,110 @@ +--- +title: clear() +slug: Web/API/Console/clear +translation_of: Web/API/Console/clear +--- +
{{APIRef("Console API")}}{{Non-standard_header}}
+ +

清空控制台.

+ +

控制台显示的内容将会被一些信息替换，比如‘Console was cleared’这样的信息。

+ +

需要的注意的一点是在Google Chrome浏览器中，如果用户在设置中勾选了“Preserve log”选项，console.clear()将不会起作用。 

+ +

语法

+ +
console.clear();
+
+ +

规范

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#consoleclear", "console.clear()")}}{{Spec2("Console API")}}Initial definition
+ +

浏览器兼容性

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatVersionUnknown}}{{CompatGeckoDesktop("48.0")}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Available in workers{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatGeckoMobile("48.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Available in workers{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

相关链接

+ + diff --git a/files/zh-cn/web/api/console/count/index.html b/files/zh-cn/web/api/console/count/index.html new file mode 100644 index 0000000000..9b28cc12df --- /dev/null +++ b/files/zh-cn/web/api/console/count/index.html @@ -0,0 +1,169 @@ +--- +title: Console.count() +slug: Web/API/Console/count +translation_of: Web/API/Console/count +--- +
{{APIRef("Console API")}}{{Non-standard_header}}
+ +

输出 count() 被调用的次数。此函数接受一个可选参数 label。

+ +

{{AvailableInWorkers}}

+ +

如果有 label，此函数输出为那个指定的 label 和 count() 被调用的次数。

+ +

如果 label 被忽略，此函数输出 count() 在其所处位置上被调用的次数。

+ +

例如，下面的代码:

+ +
var user = "";
+
+function greet() {
+  console.count();
+  return "hi " + user;
+}
+
+user = "bob";
+greet();
+user = "alice";
+greet();
+greet();
+console.count();
+ +

Console 的输出如下:

+ +
"<no label>: 1"
+"<no label>: 2"
+"<no label>: 3"
+"<no label>: 1"
+
+ +

注意最后一行的日志输出：在 11 行对 count() 的单独调用是被当作一个独立事件来处理的。

+ +

如果把变量 user 当作 label 参数传给前面调用的 count()，把字符串 "alice" 传给后面调用的 count()：

+ +
var user = "";
+
+function greet() {
+  console.count(user);
+  return "hi " + user;
+}
+
+user = "bob";
+greet();
+user = "alice";
+greet();
+greet();
+console.count("alice");
+ +

可以看到输出如下:

+ +
"bob: 1"
+"alice: 1"
+"alice: 2"
+"alice: 3"
+ +

现在可以基于不同的 label 值维护不同的数值。由于 11 行的 label 匹配了两次 user 的值，因此它不会被当作独立的事件。

+ +

语法

+ +
console.count([label]);
+
+ +

参数

+ +
+
label
+
+ +

    字符串，如果有，count() 输出此给定的 label 及其被调用的次数。

+ +

规范

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#consolecountlabel", "console.count()")}}{{Spec2("Console API")}}Initial definition
+ +

浏览器兼容性

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("30.0")}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Available in workers{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("30.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Available in workers{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
diff --git a/files/zh-cn/web/api/console/countreset/index.html b/files/zh-cn/web/api/console/countreset/index.html new file mode 100644 index 0000000000..237fbef762 --- /dev/null +++ b/files/zh-cn/web/api/console/countreset/index.html @@ -0,0 +1,132 @@ +--- +title: Console.countReset() +slug: Web/API/Console/countReset +translation_of: Web/API/Console/countReset +--- +
{{APIRef("Console API")}}
+ +

重置计数器。此函数有一个可选参数 label。

+ +

{{AvailableInWorkers}}

+ +

如果提供了参数label，此函数会重置与label关联的计数。

+ +

如果省略了参数label，此函数会重置默认的计数器。

+ +

语法

+ +
console.countReset([label]);
+
+ +

参数

+ +
+
label
+
一个字符串， 若传入此参数 countReset() 重置此label的count为0。
+
若忽略此参数  countReset() 重置count()默认的 default 字段的count为0
+  
+
+ +

返回值

+ +

若传入label参数:

+ +
 counter-name: 0
+ +

若不传入label参数:

+ +
default: 0
+ +

异常情况

+ +

若传入一个不存在的 label, countReset 返回下面的警告信息:

+ +
Counter "counter-name" doesn’t exist.
+ +

若 label 没有被传入 并且 count() 也没有被调用过, countReset 返回下面的警告信息:

+ +
Counter "default" doesn’t exist.
+ +

示例

+ +

下面给出示例代码:

+ +
var user = "";
+
+function greet() {
+  console.count();
+  return "hi " + user;
+}
+
+user = "bob";
+greet();
+user = "alice";
+greet();
+greet();
+console.count();
+console.countReset();
+ +

控制台打印输出结果:

+ +
"default: 1"
+"default: 2"
+"default: 3"
+"default: 1"
+"default: 0"
+
+ +

Note that the call to console.counterReset() resets the value of the default counter to zero.

+ +

可以看到 调用 console.counterReset() 重置了default 的计数为0

+ +

如果我们把 user 变量做为 label 传入第一次调用的 count()  把字符串 'alice' 作为第二次调用count() 的参数

+ +
var user = "";
+
+function greet() {
+  console.count(user);
+  return "hi " + user;
+}
+
+user = "bob";
+greet();
+user = "alice";
+greet();
+greet();
+console.countReset("bob");
+console.count("alice");
+ +

我们看到的输出如下:

+ +
"bob: 1"
+"alice: 1"
+"alice: 2"
+"bob: 0"
+"alice: 3"
+ +

调用countReset("bod")只是重置了 "bob" 的计数器值  而 "alice" 的计数器值没有改变。

+ +

Specifications

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#count", "console.countReset()")}}{{Spec2("Console API")}}Initial definition
+ +

Browser compatibility

+ + + +

{{Compat("api.Console.countReset")}}

diff --git a/files/zh-cn/web/api/console/debug/index.html b/files/zh-cn/web/api/console/debug/index.html new file mode 100644 index 0000000000..5e99b5ac81 --- /dev/null +++ b/files/zh-cn/web/api/console/debug/index.html @@ -0,0 +1,67 @@ +--- +title: Console.debug() +slug: Web/API/Console/debug +tags: + - 控制台 + - 调试 +translation_of: Web/API/Console/debug +--- +
{{APIRef("Console API")}}
+ +

{{domxref("Console")}}.debug() 输出“调试”级别的消息且仅仅控制台配置为显示调试输出时才显示该消息。

+ +

{{AvailableInWorkers}}

+ +

语法

+ +
console.debug(对象1 [, 对象2, ..., 对象N]);
+console.debug(消息[, 字符串1, ..., 字符串N]);
+
+ +

参数

+ +
+
对象1 ... 对象N
+
要输出的JavaScript 对象列表。 按传参的顺序把对象输出到控制台。
+
消息
+
一个JavaScript字符串，其中包含零个或多个替代字符串。
+
字符串1 ... 字符串N
+
JavaScript 对象，用来依次替换msg中的替代字符串。你可以在替代字符串中指定对象的输出格式。查看{{SectionOnPage("/zh-CN/docs/Web/API/Console", "使用字符串替换")}}了解替换字符串如何工作。
+
+ +

有关详细信息，请参阅{{domxref("console")}} 对象文档中的将文本输出到控制台。

+ +

规范

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#debug", "console.debug()")}}{{Spec2("Console API")}}Initial definition
+ +

浏览器兼容性

+ +
+ + +

{{Compat("api.Console.debug")}}

+
+ +

相关链接

+ + diff --git a/files/zh-cn/web/api/console/dir/index.html b/files/zh-cn/web/api/console/dir/index.html new file mode 100644 index 0000000000..8a8ecdf53f --- /dev/null +++ b/files/zh-cn/web/api/console/dir/index.html @@ -0,0 +1,106 @@ +--- +title: console.dir +slug: Web/API/Console/dir +translation_of: Web/API/Console/dir +--- +
{{APIRef("Console API")}}{{Non-standard_header}}
+ +

在控制台中显示指定JavaScript对象的属性，并通过类似文件树样式的交互列表显示。

+ +

{{AvailableInWorkers}}

+ +

console-dir.png

+ +

语法

+ +
console.dir(object);
+
+ +

参数

+ +
+
object
+
打印出该对象的所有属性和属性值.
+
+ +

浏览器兼容性

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("8.0")}}9{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Available in workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("8.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Available in workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

相关链接

+ + + +

 

diff --git a/files/zh-cn/web/api/console/dirxml/index.html b/files/zh-cn/web/api/console/dirxml/index.html new file mode 100644 index 0000000000..50ad5d6029 --- /dev/null +++ b/files/zh-cn/web/api/console/dirxml/index.html @@ -0,0 +1,98 @@ +--- +title: Console.dirxml() +slug: Web/API/Console/dirxml +translation_of: Web/API/Console/dirxml +--- +
{{APIRef("Console API")}}{{Non-standard_header}}
+ +

显示一个明确的XML/HTML元素的包括所有后代元素的交互树。 如果无法作为一个element被显示，那么会以JavaScript对象的形式作为替代。 它的输出是一个继承的扩展的节点列表，可以让你看到子节点的内容。

+ +

语法

+ +
console.dirxml(object);
+
+ +

参数

+ +
+
object
+
一个属性将被输出的JavaScript对象。
+
+ +

浏览器兼容性

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatUnknown}}
Available in workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Available in workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

相关链接

+ + diff --git a/files/zh-cn/web/api/console/error/index.html b/files/zh-cn/web/api/console/error/index.html new file mode 100644 index 0000000000..288f34fb4d --- /dev/null +++ b/files/zh-cn/web/api/console/error/index.html @@ -0,0 +1,170 @@ +--- +title: Console.error() +slug: Web/API/Console/error +translation_of: Web/API/Console/error +--- +
{{APIRef("Console API")}}
+ +

向 Web 控制台输出一条错误消息。

+ +

{{AvailableInWorkers}}

+ +

语法

+ +
console.error(obj1 [, obj2, ..., objN]);
+console.error(msg [, subst1, ..., substN]);
+console.exception(obj1 [, obj2, ..., objN]);
+console.exception(msg [, subst1, ..., substN]);
+
+ +
+

注意: console.exception() 是 console.error() 的别名；它们功能相同。

+
+ +

参数

+ +
+
obj1 ... objN
+
要输出的 JavaScript 对象列表。 这些对象的字符串形式按顺序加起来然后输出。
+
msg
+
一个字符串，它包含零个或多个替代字符串。
+
subst1 ... substN
+
JavaScript 对象可以用此来替换msg里的替代字符串。你可以控制输出的格式。
+
+ +

详情请看{{domxref("console")}}文档中的 输出文本到控制台 。

+ +

规范

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#error", "console.error()")}}{{Spec2("Console API")}}Initial definition
+ +

浏览器兼容性

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
基本支持{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("2.0")}}8{{CompatVersionUnknown}}{{CompatVersionUnknown}}
替代字符串{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatGeckoDesktop("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
console.exception alias{{CompatNo}}{{CompatUnknown}}{{CompatGeckoDesktop("28.0")}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
Available in workers{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
基本支持{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("2.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
替代字符串{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoMobile("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
console.exception alias{{CompatNo}}{{CompatUnknown}}{{CompatGeckoMobile("28.0")}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
Available in workers{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

相关链接

+ + diff --git a/files/zh-cn/web/api/console/group/index.html b/files/zh-cn/web/api/console/group/index.html new file mode 100644 index 0000000000..6d1c1b44a2 --- /dev/null +++ b/files/zh-cn/web/api/console/group/index.html @@ -0,0 +1,68 @@ +--- +title: console.group +slug: Web/API/Console/group +translation_of: Web/API/Console/group +--- +

{{ ApiRef() }}

+

概述

+

在 Web控制台上创建一个新的分组.随后输出到控制台上的内容都会被添加一个缩进,表示该内容属于当前分组,直到调用{{ domxref("console.groupEnd()") }}之后,当前分组结束.

+

语法

+
console.group();
+
+

参数

+

无.

+

备注

+

在文档{{ domxref("console") }}中查看在控制台中使用分组,了解更多详细内容.

+

规范

+

不属于任何公开的规范

+

浏览器兼容性

+

{{ CompatibilityTable() }}

+
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support2{{ CompatGeckoDesktop("2.0") }}{{ CompatUnknown() }}{{ CompatVersionUnknown() }}4.0
+
+
+ + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{ CompatUnknown() }}{{ CompatGeckoMobile("2.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
+
+

相关链接

+ +

{{ languages( {"en": "en/DOM/console.group" } ) }}

diff --git a/files/zh-cn/web/api/console/groupcollapsed/index.html b/files/zh-cn/web/api/console/groupcollapsed/index.html new file mode 100644 index 0000000000..ee1a798f2a --- /dev/null +++ b/files/zh-cn/web/api/console/groupcollapsed/index.html @@ -0,0 +1,70 @@ +--- +title: console.groupCollapsed +slug: Web/API/Console/groupCollapsed +translation_of: Web/API/Console/groupCollapsed +--- +

{{ ApiRef() }}

+

概述

+

在 Web控制台上创建一个新的分组.随后输出到控制台上的内容都会被添加一个缩进,表示该内容属于当前分组,直到调用console.groupEnd() 之后,当前分组结束.和 {{ domxref("console.group()") }}方法的不同点是,新建的分组默认是折叠的.用户必须点击一个按钮才能将折叠的内容打开.

+

语法

+
console.groupCollapsed();
+
+

参数

+

无

+

备注

+

在文档{{ domxref("console") }}中查看在控制台中使用分组,了解更多详细内容.

+

规范

+

不属于任何公开的规范

+

浏览器

+

{{ CompatibilityTable() }}

+
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support6{{ CompatGeckoDesktop("9.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}5.1
+
+
+ + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{ CompatUnknown() }}{{ CompatGeckoMobile("9.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
+
+

Gecko 备注

+

从Gecko 9.0 {{ geckoRelease("9.0") }}开始,Firefox自带的web控制台开始支持该方法, 但是该方法新建的分组不是折叠的,也就是说该方法的功能等同于 {{ domxref("console.group()") }}.

+

相关链接

+ +

{{ languages( { "en": "en/DOM/console.groupCollapsed" } ) }}

diff --git a/files/zh-cn/web/api/console/groupend/index.html b/files/zh-cn/web/api/console/groupend/index.html new file mode 100644 index 0000000000..a90ae09cf3 --- /dev/null +++ b/files/zh-cn/web/api/console/groupend/index.html @@ -0,0 +1,118 @@ +--- +title: Console.groupEnd() +slug: Web/API/Console/groupEnd +translation_of: Web/API/Console/groupEnd +--- +

{{APIRef("Console API")}}

+ +

在 Web控制台中退出一格缩进(结束分组). 请参阅 {{domxref("console")}} 中的Using groups in the console 来获取它的用法和示例.

+ +

{{AvailableInWorkers}}

+ +

语法

+ +
console.groupEnd();
+
+ +

参数

+ +

None.

+ +

Specifications

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#groupend", "console.groupEnd()")}}{{Spec2("Console API")}}Initial definition
+ +

浏览器兼容性

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support2{{CompatVersionUnknown}}{{CompatGeckoDesktop("9.0")}}11{{CompatVersionUnknown}}4.0[1]
Available in workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Available in workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

[1] Implemented in http://trac.webkit.org/changeset/35421.

+ +

See also

+ + diff --git a/files/zh-cn/web/api/console/index.html b/files/zh-cn/web/api/console/index.html new file mode 100644 index 0000000000..f66e3de417 --- /dev/null +++ b/files/zh-cn/web/api/console/index.html @@ -0,0 +1,303 @@ +--- +title: Console +slug: Web/API/Console +tags: + - API + - Debugging + - Interface + - Reference + - console + - web console +translation_of: Web/API/Console +--- +
{{APIRef("Console API")}}
+ +

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

+ +

Console 对象可以从任何全局对象中访问到，如 浏览器作用域上的 {{domxref("Window")}}，以及通过属性控制台作为workers中的特定变体的 {{domxref("WorkerGlobalScope")}}。可以通过 {{domxref("Window.console")}} 引用，也可以简单的通过 console 引用。例：

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

本页面记录了 Console 对象上的 {{anch("Methods")}}（方法）并给出了几个 {{anch("Usage")}} （用例）。

+ +

{{AvailableInWorkers}}

+ +
+

提示: 实际的 console 接口被定义为全小写的形式（比如不是这种形式 Console ），这是历史原因导致的。

+
+ +

方法

+ +
+
{{domxref("Console.assert()")}}
+
如果第一个参数为 false ，则将消息和堆栈跟踪记录到控制台。
+
{{domxref("Console.clear()")}}
+
清空控制台，并输出 Console was cleared。
+
{{domxref("Console.count()")}}
+
以参数为标识记录调用的次数，调用时在控制台打印标识以及调用次数。
+
{{domxref("Console.countReset()")}}
+
重置指定标签的计数器值。
+
{{domxref("Console.debug()")}}
+
在控制台打印一条 "debug" 级别的消息。
+
{{domxref("Console.dir()")}}
+
显示一个由特定的 Javascript 对象列表组成的可交互列表。这个列表可以使用三角形隐藏和显示来审查子对象的内容。.
+
{{domxref("Console.dirxml()")}}
+
打印 XML/HTML 元素表示的指定对象，否则显示 JavaScript 对象视图。
+
{{domxref("Console.error()")}}
+
打印一条错误信息，使用方法可以参考 string substitution。
+
{{domxref("Console.exception()")}} {{Non-standard_inline}} {{deprecated_inline}}
+
error() 方法的别称。
+
{{domxref("Console.group()")}}
+
创建一个新的内联 group, 后续所有打印内容将会以子层级的形式展示。调用 groupEnd()来闭合组。
+
{{domxref("Console.groupCollapsed()")}}
+
创建一个新的内联 group。使用方法和 group() 相同，不同的是，groupCollapsed() 方法打印出来的内容默认是折叠的。调用groupEnd()来闭合组。
+
{{domxref("Console.groupEnd()")}}
+
闭合当前内联 group。
+
{{domxref("Console.info()")}}
+
打印资讯类说明信息，使用方法可以参考 string substitution。
+
{{domxref("Console.log()")}}
+
打印内容的通用方法，使用方法可以参考 string substitution。
+
{{domxref("Console.profile()")}} {{Non-standard_inline}}
+
Starts the browser's built-in profiler (for example, the Firefox performance tool). You can specify an optional name for the profile.
+
{{domxref("Console.profileEnd()")}} {{Non-standard_inline}}
+
Stops the profiler. You can see the resulting profile in the browser's performance tool (for example, the Firefox performance tool).
+
{{domxref("Console.table()")}}
+
将列表型的数据打印成表格。
+
{{domxref("Console.time()")}}
+
启动一个以入参作为特定名称的计时器，在显示页面中可同时运行的计时器上限为10,000.
+
{{domxref("Console.timeEnd()")}}
+
结束特定的 计时器 并以豪秒打印其从开始到结束所用的时间。
+
{{domxref("Console.timeLog()")}}
+
打印特定 计时器 所运行的时间。
+
{{domxref("Console.timeStamp()")}} {{Non-standard_inline}}
+
添加一个标记到浏览器的 Timeline 或 Waterfall 工具。
+
{{domxref("Console.trace()")}}
+
输出一个 stack trace。
+
{{domxref("Console.warn()")}}
+
打印一个警告信息，可以使用 string substitution 和额外的参数。
+
+ +

用法

+ +

输出文本到控制台

+ +

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

+ +

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

+ +

打印单个对象

+ +

The simplest way to use the logging methods is to output a single object:

+ +
var someObject = { str: "Some text", id: 5 };
+console.log(someObject);
+
+ +

打印结果类似下面:

+ +
[09:27:13.475] ({str:"Some text", id:5})
+ +

打印多个对象

+ +

可以打印多个对象，就像下面一样：

+ +
var car = "Dodge Charger";
+var someObject = { str: "Some text", id: 5 };
+console.info("My first car was a", car, ". The object is:", someObject);
+ +

打印结果类似下面：

+ +
[09:28:22.711] My first car was a Dodge Charger . The object is: ({str:"Some text", id:5})
+ +

使用字符串替换

+ +

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

+ + + + + + + + + + + + + + + + + + + + + + + + +
Substitution stringDescription
%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 不支持精确格式化。

+
+ +

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

+ +
for (var i=0; i<5; i++) {
+  console.log("Hello, %s. You've called me %d times.", "Bob", i+1);
+}
+
+ +

输出样例如下所示：

+ +
[13:14:13.481] Hello, Bob. You've called me 1 times.
+[13:14:13.483] Hello, Bob. You've called me 2 times.
+[13:14:13.485] Hello, Bob. You've called me 3 times.
+[13:14:13.487] Hello, Bob. You've called me 4 times.
+[13:14:13.488] Hello, Bob. You've called me 5 times.
+
+ +

为控制台定义样式

+ +

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

+ +
console.log("This is %cMy stylish message", "color: yellow; font-style: italic; background-color: blue;padding: 2px");
+ +
+ +
指令前的文本不会受到影响，但指令后的文本将会使用参数中声明的 CSS 样式。
+ +
+


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

+ + + +

注意: 控制台信息的默认行为与行内元素相似。为了应用 padding, margin 这类效果，你应当这样设置display: inline-block.。

+
+ +

在 console 中使用编组

+ +

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

+ +

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

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

执行结果:

+ +

Demo of nested groups in Firefox console

+ +

定时器

+ +

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

+ +

示例：:

+ +
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 后，把结束时间打印到控制台。

+ +

timerresult.png

+ +

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

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

堆栈跟踪

+ +

控制台也支持输出堆栈，其将会显示到调用 {{domxref("console.trace()")}} 的点的调用路径。如下所示：

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

控制台的输出：

+ +

+ +

规范

+ + + + + + + + + + + + + + +
规范状态备注
{{SpecName('Console API')}}{{Spec2('Console API')}}Initial definition.
+ +

浏览器兼容性

+ + + +

{{Compat("api.Console")}}

+ +

注意

+ + + +

相关文档

+ + + +

其他实现

+ + diff --git a/files/zh-cn/web/api/console/info/index.html b/files/zh-cn/web/api/console/info/index.html new file mode 100644 index 0000000000..0b946b9719 --- /dev/null +++ b/files/zh-cn/web/api/console/info/index.html @@ -0,0 +1,155 @@ +--- +title: Console.info() +slug: Web/API/Console/info +translation_of: Web/API/Console/info +--- +
{{APIRef("Console API")}}
+ +

向web控制台输出一个通知信息。仅在Firefox，web控制台的日志中的项目旁边会显示一个小的‘I‘图标

+ +

{{AvailableInWorkers}}

+ +

语法

+ +
console.info(obj1 [, obj2, ..., objN]);
+console.info(msg [, subst1, ..., substN]);
+
+ +

参数

+ +
+
obj1 ... objN
+
要输出的JavaScript对象列表。对象obj1,obj2,...列出顺序和输出顺序一致。
+
msg
+
JavaScript字符串。可包含零个或多个替换字符串。
+
subst1 ... substN
+
+ +

     用于替换msg内的替换字符串的JavaScript对象。 可以对输出的格式进行额外的控制。

+ +

查看更多细节可访问 {{domxref("console")}} 文件内的Outputting text to the console

+ +

规范

+ + + + + + + + + + + + + + + + +
规范状态注释
{{SpecName("Console API", "#info", "console.info()")}}{{Spec2("Console API")}}初次定义
+ +

浏览器兼容

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
特性ChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
基础支持{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("2.0")}}8{{CompatVersionUnknown}}{{CompatVersionUnknown}}
替换字符串{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
信息标志{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}}
在 Web Worker 中可用{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
特性AndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
基础支持{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("2.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
替换字符串{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
在 Web Worker 中可用{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

参见

+ + diff --git a/files/zh-cn/web/api/console/log/index.html b/files/zh-cn/web/api/console/log/index.html new file mode 100644 index 0000000000..5650dfe8bd --- /dev/null +++ b/files/zh-cn/web/api/console/log/index.html @@ -0,0 +1,124 @@ +--- +title: console.log +slug: Web/API/Console/log +translation_of: Web/API/Console/log +--- +

{{ ApiRef() }}

+ +

概述

+ +

向 Web 控制台输出一条消息。

+ +

语法

+ +
console.log(obj1 [, obj2, ..., objN]);
+console.log(msg [, subst1, ..., substN]);
+console.log('String: %s, Int: %d,Float: %f, Object: %o', str, ints, floats, obj)
+console.log(`temp的值为: ${temp}`)
+
+ +

参数

+ +
+
obj1 ... objN
+
一个用于输出的 JavaScript 对象列表。其中每个对象会以字符串的形式按照顺序依次输出到控制台。
+
msg
+
一个JavaScript字符串，其中包含零个或多个替代字符串。
+
subst1 ... substN
+
JavaScript 对象，用来依次替换msg中的替代字符串。你可以在替代字符串中指定对象的输出格式。
+
+ +

查看向控制台输出文本来了解更多{{ domxref("console") }}对象的用法。

+ +

浏览器兼容性

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
基本功能{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("2.0")}}8{{CompatVersionUnknown}}{{CompatVersionUnknown}}
替代字符串{{CompatVersionUnknown}}
+ {{CompatChrome(28)}}[1]		{{CompatVersionUnknown}}{{CompatGeckoDesktop("9.0")}}10[2]{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Available in workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
基本功能{{ CompatUnknown() }}{{ CompatGeckoMobile("2.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
替代字符串{{ CompatUnknown() }}{{ CompatGeckoMobile("9.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
+
+ +

规范

+ +

不属于任何公开的规范

+ +

相关链接

+ + + +

{{ languages( {"en": "en/DOM/console.log" } ) }}

diff --git a/files/zh-cn/web/api/console/profile/index.html b/files/zh-cn/web/api/console/profile/index.html new file mode 100644 index 0000000000..fc611fe671 --- /dev/null +++ b/files/zh-cn/web/api/console/profile/index.html @@ -0,0 +1,114 @@ +--- +title: Console.profile() +slug: Web/API/Console/profile +tags: + - API + - DOM + - Web开发 + - web控制台 + - 参考 + - 描述信息 + - 方法 + - 调试 + - 非标准 +translation_of: Web/API/Console/profile +--- +

{{APIRef("Console API")}}{{Non-standard_header}}

+ +

开始记录性能描述信息(例如,  Firefox performance tool)。

+ +

你可以选择提供一个参数来命名描述信息，这将允许你在有多个描述信息被记录时来选择只停止那个描述信息（被你命名的那个）。请查阅{{domxref("Console.profileEnd()")}}来确认这个参数是如何被解释的。

+ +

要停止记录，请调用{{domxref("Console.profileEnd()")}}。

+ +

{{AvailableInWorkers}}

+ +

Syntax

+ +
console.profile(profileName);
+
+ +

Parameters

+ +
+
profileName
+
描述信息的名字。可选。
+
+ +

浏览器兼容性

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
特性ChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
基本支持{{CompatChrome("53.0")}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatUnknown}}
实际可用{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
基本支持{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("10.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
实际可用{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

参见

+ + diff --git a/files/zh-cn/web/api/console/profileend/index.html b/files/zh-cn/web/api/console/profileend/index.html new file mode 100644 index 0000000000..6e1bb6ece9 --- /dev/null +++ b/files/zh-cn/web/api/console/profileend/index.html @@ -0,0 +1,46 @@ +--- +title: Console.profileEnd() +slug: Web/API/Console/profileEnd +translation_of: Web/API/Console/profileEnd +--- +

{{APIRef("Console API")}}{{Non-standard_header}}

+ +
+

在 console.profile() 之后立刻调用此API可能会导致其无法工作.。为解决此问题，请在setTimeOut中至少延迟5毫秒后再调用。 请看 bug #1173588。

+
+ +

profileEnd方法会停止记录之前已经由{{domxref("Console.profile()")}}开始记录的性能描述信息

+ +

你可以选择提供一个参数来命名需要记录的描述信息。这使得你在记录多个描述信息的时候可以停止记录特定的描述信息。

+ + + +

{{AvailableInWorkers}}

+ +

语法

+ +
console.profileEnd(profileName);
+
+ +

参数

+ +
+
profileName
+
描述信息的名字。可选。
+
+ +

浏览器兼容性

+ + + +

{{Compat("api.Console.profileEnd")}}

+ +

参见

+ + diff --git a/files/zh-cn/web/api/console/table/index.html b/files/zh-cn/web/api/console/table/index.html new file mode 100644 index 0000000000..85d5ba2822 --- /dev/null +++ b/files/zh-cn/web/api/console/table/index.html @@ -0,0 +1,151 @@ +--- +title: Console.table() +slug: Web/API/Console/table +tags: + - API + - Web 开发 + - 控制台 + - 方法 + - 调试 +translation_of: Web/API/Console/table +--- +
{{APIRef("Console API")}}
+ +

将数据以表格的形式显示。

+ +

这个方法需要一个必须参数 data，data 必须是一个数组或者是一个对象；还可以使用一个可选参数 columns。

+ +

它会把数据 data 以表格的形式打印出来。数组中的每一个元素（或对象中可枚举的属性）将会以行的形式显示在表格中。

+ +

表格的第一列是 index。如果数据 data 是一个数组，那么这一列的单元格的值就是数组的索引。 如果数据是一个对象，那么它们的值就是各对象的属性名称。 注意（在 FireFox 中）console.table 被限制为只显示1000行（第一行是被标记的索引（原文：labeled index））。

+ +

{{AvailableInWorkers}}

+ +

打印单一参数类型

+ +

数据的参数类型可以是数组或是对象。

+ +
// 打印一个由字符串组成的数组
+
+console.table(["apples", "oranges", "bananas"]);
+ +

+ +
// 打印一个属性值是字符串的对象
+
+function Person(firstName, lastName) {
+  this.firstName = firstName;
+  this.lastName = lastName;
+}
+
+var me = new Person("John", "Smith");
+
+console.table(me);
+ +

+ +

打印复合的参数类型

+ +

如果需要打印的元素在一个数组中，或者需要打印的属性在一个对象，并且他们本身就是一个数组或者对象，则将会把这个元素显示在同一行，每个元素占一列：

+ +
// 二元数组的打印
+
+var people = [["John", "Smith"], ["Jane", "Doe"], ["Emily", "Jones"]]
+console.table(people);
+ +

Table displaying array of arrays

+ +
// 打印一个包含对象的数组
+
+function Person(firstName, lastName) {
+  this.firstName = firstName;
+  this.lastName = lastName;
+}
+
+var john = new Person("John", "Smith");
+var jane = new Person("Jane", "Doe");
+var emily = new Person("Emily", "Jones");
+
+console.table([john, jane, emily]);
+ +

请注意，如果数组包含对象，则列将使用属性名称进行标记。

+ +

结果显示，如果数组中包含该对象，打印出来的列标签将是该对象的属性名

+ +

Table displaying array of objects

+ +
// 打印属性名是对象的对象
+
+var family = {};
+
+family.mother = new Person("Jane", "Smith");
+family.father = new Person("John", "Smith");
+family.daughter = new Person("Emily", "Smith");
+
+console.table(family);
+ +

Table displaying object of objects

+ +

选择要隐藏的列

+ +

console.table() 会把所有元素罗列在每一列，你可以使用 columns 参数选择要显示的列的子集：

+ +
// 一个对象数组，只打印 firstName
+
+function Person(firstName, lastName) {
+  this.firstName = firstName;
+  this.lastName = lastName;
+}
+
+var john = new Person("John", "Smith");
+var jane = new Person("Jane", "Doe");
+var emily = new Person("Emily", "Jones");
+
+console.table([john, jane, emily], ["firstName"]);
+ +

Table displaying array of objects with filtered output

+ +

按列重新排序

+ +

你可以点击每列的顶部标签来重排输出的表格。

+ +

语法

+ +
console.table(data [, columns]);
+
+ +

参数

+ +
+
data
+
要显示的数据。必须是数组或对象。
+
columns
+
一个包含列的名称的数组。
+
+ +

规范

+ + + + + + + + + + + + + + + + +
规范状态备注
{{SpecName("Console API", "#table", "console.table()")}}{{Spec2("Console API")}}Initial definition
+ +

浏览器兼容性

+ +
+ + +

{{Compat("api.Console.table")}}

+
diff --git a/files/zh-cn/web/api/console/time/index.html b/files/zh-cn/web/api/console/time/index.html new file mode 100644 index 0000000000..0bb67dc2c9 --- /dev/null +++ b/files/zh-cn/web/api/console/time/index.html @@ -0,0 +1,55 @@ +--- +title: console.time +slug: Web/API/Console/time +translation_of: Web/API/Console/time +--- +

{{ ApiRef() }}

+ +

你可以启动一个计时器来跟踪某一个操作的占用时长。每一个计时器必须拥有唯一的名字，页面中最多能同时运行10,000个计时器。当以此计时器名字为参数调用 {{ domxref("console.timeEnd()") }} 时，浏览器将以毫秒为单位，输出对应计时器所经过的时间。

+ +

关于 Timers 的细节和例子请参考文档 {{ domxref("console") }} 。

+ +

{{AvailableInWorkers}}

+ +

语法

+ +
console.time(timerName);
+
+ +

参数

+ +
+
timerName
+
新计时器的名字。 用来标记这个计时器，作为参数调用 {{ domxref("console.timeEnd()") }}可以停止计时并将经过的时间在终端中打印出来.
+
+ +

规范

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#time", "console.time()")}}{{Spec2("Console API")}}Initial definition
+ +

浏览器兼容性

+ +

{{Compat("api.Console.time")}}

+ +

参阅

+ + diff --git a/files/zh-cn/web/api/console/timeend/index.html b/files/zh-cn/web/api/console/timeend/index.html new file mode 100644 index 0000000000..57a38b8079 --- /dev/null +++ b/files/zh-cn/web/api/console/timeend/index.html @@ -0,0 +1,61 @@ +--- +title: Console.timeEnd() +slug: Web/API/Console/timeEnd +translation_of: Web/API/Console/timeEnd +--- +
{{APIRef("Console API")}}{{Non-standard_header}}
+ +

概述

+ +

停止一个通过 console.time() 启动的计时器

+ +
+

注意:该方法在使用时不会将输出的时间返回到js,它只能用于控制台调试.请勿将该方法作为普通计时器或性能数据收集器的一部分.

+
+ +

有关详细信息和示例，请参阅 Timers

+ +

{{AvailableInWorkers}}

+ +

语法

+ +
console.timeEnd(label);
+
+ +

参数

+ +
+
label
+
需要停止的计时器名字。一旦停止，计时器所经过的时间会被自动输出到控制台。
+
+ +

Specifications

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#consoletimeendlabel", "console.timeEnd()")}}{{Spec2("Console API")}}Initial definition
+ +

浏览器兼容性

+ +
{{Compat("api.Console.timeEnd")}}
+ +
+ +

相关链接

+ + diff --git a/files/zh-cn/web/api/console/timelog/index.html b/files/zh-cn/web/api/console/timelog/index.html new file mode 100644 index 0000000000..9dc87c6071 --- /dev/null +++ b/files/zh-cn/web/api/console/timelog/index.html @@ -0,0 +1,102 @@ +--- +title: Console.timeLog() +slug: Web/API/Console/timeLog +tags: + - API + - DOM + - Debugging + - Method + - Web Development + - console + - web console +translation_of: Web/API/Console/timeLog +--- +
{{APIRef("Console API")}}
+ +
在控制台输出计时器的值，该计时器必须已经通过 {{domxref("console.time()")}} 启动。
+ +
+ +

参阅文档中的 Timers 部分获取详细说明和示例。 

+ +

{{AvailableInWorkers}}

+ +

语法

+ +
console.timeLog(label);
+
+ +

参数

+ +
+
label
+
计时器索引。
+
+ +

返回值

+ +

如果没有传入 label 参数，则以 default: 作为引导返回数据：

+ +
default: 1042ms
+ +

如果传入了一个已经存在的 label ，则会以 label:  作为引导返回数据：

+ +
label: 1242ms
+ +

异常

+ +

如果计时器未启动， timeLog() 会返回一个警告：

+ +
Timer “default” doesn’t exist.
+ +

如果传入的 label 索引没有与之对应的计时器，则返回如下警告：

+ +
Timer “timer name” doesn’t exist.
+ +

示例

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

上例中的输出分别显示了用户从打开页面到关闭第一个 alert 和第二个 alert 框的时间间隔：

+ +

+ +

注意：使用 timelog() 输出计时器的值会显示计时器名称。使用 timeEnd() 停止也会显示计时器名称和输出计时器的值，并且，最后的 " - timer ended" 可以清楚的显示计时器不再计时的信息。

+ +

规范

+ + + + + + + + + + + + + + + + +
规范状态注释
{{SpecName("Console API", "#timelog", "console.timeLog()")}}{{Spec2("Console API")}}Initial definition
+ +

浏览器兼容性

+ +
+ + +

{{Compat("api.Console.timeLog")}}

+
+ +

相关文档

+ + diff --git a/files/zh-cn/web/api/console/timestamp/index.html b/files/zh-cn/web/api/console/timestamp/index.html new file mode 100644 index 0000000000..ed92f19a27 --- /dev/null +++ b/files/zh-cn/web/api/console/timestamp/index.html @@ -0,0 +1,98 @@ +--- +title: Console.timeStamp() +slug: Web/API/Console/timeStamp +translation_of: Web/API/Console/timeStamp +--- +
{{APIRef("Console API")}}{{Non-standard_header}}
+ +

向浏览器的 Performance 或者 Waterfall 工具添加一个标记。这样可以让你将代码中的一个点和其他在时间轴上已记录的事件相关联，例如布局事件和绘制事件等。

+ +

你可以选择用一个参数来作为时间戳标签，然后标记旁边就会显示这个标签。

+ +

{{AvailableInWorkers}}

+ +

Syntax

+ +
console.timeStamp(label);
+
+ +

Parameters

+ +
+
label
+
Label for the timestamp. Optional.
+
+ +

Browser compatibility

+ +

{{CompatibilityTable}}

+ +
{{CompatUnknown}} + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Available in workers{{CompatVersionUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatGeckoMobile("10.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Available in workers{{CompatUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

See also

+ + diff --git a/files/zh-cn/web/api/console/trace/index.html b/files/zh-cn/web/api/console/trace/index.html new file mode 100644 index 0000000000..682eba535e --- /dev/null +++ b/files/zh-cn/web/api/console/trace/index.html @@ -0,0 +1,70 @@ +--- +title: console.trace +slug: Web/API/Console/trace +translation_of: Web/API/Console/trace +--- +

{{APIRef("Console API")}}

+ +

{{domxref("console")}} 的 trace() 方法向 Web控制台 输出一个堆栈跟踪。

+ +

{{AvailableInWorkers}}

+ +

在页面{{ domxref("console") }}文档中查看堆栈跟踪的详细介绍和示例。

+ +

语法

+ +
console.trace( [...any, ...data ]);
+ +

参数

+ +
+
...any, ...data {{optional_inline}}
+
Zero or more objects to be output to console along with the trace. These are assembled and formatted the same way they would be if passed to the {{domxref("console.log()")}} method.
+
+ +

Example

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

In the console, the following trace will be displayed:

+ +
bar
+foo
+<anonymous>
+ +

规范

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#trace", "console.trace()")}}{{Spec2("Console API")}}Initial definition
+ +

浏览器兼容性

+ +

{{Compat("api.Console.trace")}}

+ +

See also

+ + diff --git a/files/zh-cn/web/api/console/warn/index.html b/files/zh-cn/web/api/console/warn/index.html new file mode 100644 index 0000000000..c3ba21b2b0 --- /dev/null +++ b/files/zh-cn/web/api/console/warn/index.html @@ -0,0 +1,147 @@ +--- +title: Console.warn() +slug: Web/API/Console/warn +translation_of: Web/API/Console/warn +--- +
{{APIRef("Console API")}}
+ +

向 Web 控制台输出一条警告信息。

+ +

{{AvailableInWorkers}}

+ +

{{Note("在火狐浏览器里，警告会有一个小感叹号图标在 Web 控制台信息前面。")}}

+ +

语法

+ +
console.warn(obj1 [, obj2, ..., objN]);
+console.warn(msg [, subst1, ..., substN]);
+
+ +

参数

+ +
+
obj1 ... objN
+
要输出的 Javascript 对象列表。其中每个对象会以字符串的形式按照顺序依次输出到控制台。
+
msg
+
一个 JavaScript 字符串，其中包含零个或多个替代字符串。
+
subst1 ... substN
+
零个或多个 Javascript 对象 依次替换 msg 中的替代字符串，你可以在替代字符串中指定对象的输出格式。
+
+ +

查看 向控制台输出文本 来了解更多 {{domxref("console")}} 的用法。

+ +

规范

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#warn", "console.warn()")}}{{Spec2("Console API")}}Initial definition
+ +

浏览器兼容

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("2.0")}}8{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Substitution strings{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Available in workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("2.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Substitution strings{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Available in workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

相关链接

+ + -- cgit v1.2.3-54-g00ecf