Performance.measure()

The measure() method creates a named timestamp in the browser's performance entry buffer between two specified marks (known as the start mark and end mark, respectively). The named timestamp is referred to as a measure.

The measure can be retrieved by one of the Performance interface's getEntries*() methods (getEntries(), getEntriesByName() or getEntriesByType()).

The measure's performance entry will have the following property values:

• entryType - set to "measure".
• name - set to the "name" given when the measure was created.
• startTime - set to the timestamp when measure() was called.
• duration - set to a DOMHighResTimeStamp that is the duration of the measure (typically, the end mark timestamp minus the start mark timestamp).

Syntax

performance.measure(name, startMark, endMark);

Arguments

name

A DOMString representing the name of the measure.

startMark Optional

A DOMString representing the name of the measure's starting mark. May also be the name of a PerformanceTiming property.

endMark Optional

A DOMString representing the name of the measure's ending mark. May also be the name of a PerformanceTiming property.

Return value

void

 

Example

The following example shows how measure() is used to create a new measure performance entry in the browser's performance entry buffer.

function create_measure(name, markStart, markEnd) {
  if (performance.measure === undefined) {
    console.log("performance.measure Not supported");
    return;
  }
  // Create the performance measure between the two marks
  performance.measure(name, markStart, markEnd);
}

Specifications

Browser compatibility