此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

console:countReset() 静态方法

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2020年1月⁩.

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

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

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

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

语法

js
countReset() countReset(label) 

参数

label

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

返回值

若传入 label 参数:

 counter-name: 0 

若不传入 label 参数:

default: 0 

异常情况

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

Counter "counter-name" doesn’t exist. 

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

Counter "default" doesn’t exist. 

示例

下面给出示例代码:

js
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() 的参数

js
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" 的计数器值没有改变。

规范

Specification
Console
# countreset

浏览器兼容性