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.

StopWatch - StopWatch()

Creates an instance of the StopWatch class.

Uses the current time as the start time.

Table 1. Parameters
Name Type Description
None

Example

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.

Table 2. Parameters
Name Type Description
initialDate Date The initial date for the object.

StopWatch - getTime()

Returns the number of milliseconds since the timer started.

Table 3. Parameters
Name Type Description
None
Table 4. Returns
Type Description
Number Time since the timer started.

Unit: Milliseconds

Example

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.

Table 5. Parameters
Name Type Description
None
Table 6. Returns
Type Description
void

Example

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.

Table 7. Parameters
Name Type Description
None
Table 8. Returns
Type Description
String Elapsed time.

Format: HH:MM:SS.SSS

Example

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();