Console.countReset()

Resets the counter. This function takes an optional argument label.

Note: This feature is available in Web Workers.

If label is supplied, this function resets the count associated with that particular label.

If label is omitted, the function resets the default counter.

Syntax

console.countReset([label]);

Parameters

label
A string.
If supplied, countReset() resets the count for that label to 0.
If omitted, count() resets the default counter to 0.

Return value

If a label parameter was supplied:

 counter-name: 0

If no label was supplied:

default: 0

Exceptions

If label is supplied and does not exist, countReset returns the warning:

Counter "counter-name" doesn’t exist.

If label is not supplied and count() has not been callsed, countReset returns the warning:

Counter "default" doesn’t exist.

Examples

For example, given code like this:

var user = "";

function greet() {
  console.count();
  return "hi " + user;
}

user = "bob";
greet();
user = "alice";
greet();
greet();
console.count();
console.countReset();

Console output will look something like this:

"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.

If we pass the user variable as the label argument to the first invocation of count(), and the string "alice" to the second:

var user = "";

function greet() {
  console.count(user);
  return "hi " + user;
}

user = "bob";
greet();
user = "alice";
greet();
greet();
console.countReset("bob");
console.count("alice");

We will see output like this:

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

Resetting the value of the counter "bob" only changes the value of that counter. The value of "alice" is unchanged.

Specifications

Specification Status Comment
Console API
The definition of 'console.countReset()' in that specification.
Living Standard Initial definition

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic supportChrome Full support YesEdge ? Firefox Full support 62IE No support NoOpera Full support YesSafari ? WebView Android Full support YesChrome Android Full support YesEdge Mobile ? Firefox Android Full support 62Opera Android ? Safari iOS ? Samsung Internet Android Full support Yes

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown

Document Tags and Contributors

Contributors to this page: irenesmith, chrisdavidmills
Last updated by: irenesmith,