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

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support Yes ?62 No Yes ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support Yes Yes ?62 ? ? Yes

Document Tags and Contributors

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