console: timeLog() static method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Note: This feature is available in Web Workers.
The console.timeLog()
static method logs the current value of a timer that was previously started by calling console.time()
.
Syntax
console.timeLog()
console.timeLog(label)
console.timeLog(label, val1)
console.timeLog(label, val1, /* …, */ valN)
Parameters
label
Optional-
The name of the timer to log to the console. If this is omitted the label "default" is used.
valN
Optional-
Additional values to be logged to the console after the timer output.
Return value
None (undefined
).
Description
The console.timeLog()
method logs the current value of a timer.
The method can be passed the name of a timer. This will attempt to log the value of a timer created with that name in a previous call to console.time()
:
console.time("reticulating splines");
reticulateSplines();
console.timeLog("reticulating splines");
// reticulating splines: 650ms
If the timer name is omitted, then the timer is named "default"
:
console.time();
reticulateSplines();
console.timeLog();
// default: 780ms
console.time("default");
reticulateSplines();
console.timeLog();
// default: 780ms
If there is no corresponding timer, console.timeLog()
logs a warning like:
Timer "timer name" doesn't exist.
You can log additional values to the console after the timer output:
console.time();
reticulateSplines();
console.timeLog("default", "Hello", "world");
// default: 780ms Hello world
See Timers in the documentation for more details and examples.
Examples
console.time("answer time");
alert("Click to continue");
console.timeLog("answer time");
alert("Do a bunch of other stuff…");
console.timeEnd("answer time");
The output from the example above shows the time taken by the user to dismiss the first alert box, followed by the cumulative time it took for the user to dismiss both alerts:
answer time: 2542ms debugger eval code:3:9 answer time: 4161ms - timer ended
Notice that the timer's name is displayed when the timer value is logged using console.timeLog()
and again when it's stopped. In addition, the call to console.timeEnd()
has the additional information, "timer ended" to make it obvious that the timer is no longer tracking time.
Specifications
Specification |
---|
Console Standard # timelog |
Browser compatibility
BCD tables only load in the browser
See also
console.time()
- See
console.timeEnd()
for additional examples - Node.js documentation for
console.timeLog()