Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

StopWatch- Client

The StopWatch API provides methods to measure the duration of operations.

You can use this API in client-side scripts using ListV2 and ListV3 APIs.

Parent Topic:Client API reference

StopWatch - StopWatch()

Creates an instance of the StopWatch class.

Uses the current time as the start time.

NameTypeDescription
None  
var sw = new StopWatch();

// some slow code here
for(var i=0,j=1;i<100000000;i++) {
    j=Math.sqrt(i*i*j);
}

if (sw.getTime() > 500)
    console.log("Long running script. Execution time: [" + sw.toString() + "]");

sw.restart();

// some faster code
for(i=0,j;i<100000;i++) {
    j= i + Math.random() * i;
}

console.log("Finished in: " + sw.getTime() + "ms");
sw.stop();

StopWatch - StopWatch(Date initialDate)

Creates an instance of the StopWatch class using the specified date as the initial value.

NameTypeDescription
initialDateDateThe initial date for the object.

StopWatch - getTime()

Returns the number of milliseconds since the timer started.

NameTypeDescription
None  
TypeDescription
NumberTime since the timer started.Unit: Milliseconds
var sw = new StopWatch();

// some slow code here
for(var i=0,j=1;i<100000000;i++) {
    j=Math.sqrt(i*i*j);
}

if (sw.getTime() > 500)
    console.log("Long running script. Execution time: [" + sw.toString() + "]");

sw.restart();

// some faster code
for(i=0,j;i<100000;i++) {
    j= i + Math.random() * i;
}

console.log("Finished in: " + sw.getTime() + "ms");
sw.stop();

StopWatch - restart()

Resets the timer start to the current time.

NameTypeDescription
None  
TypeDescription
void 
var sw = new StopWatch();

// some slow code here
for(var i=0,j=1;i<100000000;i++) {
    j=Math.sqrt(i*i*j);
}

if (sw.getTime() > 500)
    console.log("Long running script. Execution time: [" + sw.toString() + "]");

sw.restart();

// some faster code
for(i=0,j;i<100000;i++) {
    j= i + Math.random() * i;
}

console.log("Finished in: " + sw.getTime() + "ms");
sw.stop();

StopWatch - toString()

Returns the elapsed time.

NameTypeDescription
None  
TypeDescription
StringElapsed time. Format: HH:MM:SS.SSS
var sw = new StopWatch();

// some slow code here
for(var i=0,j=1;i<100000000;i++) {
    j=Math.sqrt(i*i*j);
}

if (sw.getTime() > 500)
    console.log("Long running script. Execution time: [" + sw.toString() + "]");

sw.restart();

// some faster code
for(i=0,j;i<100000;i++) {
    j= i + Math.random() * i;
}

console.log("Finished in: " + sw.getTime() + "ms");
sw.stop();