Performance.mark()

The mark() method creates a timestamp in the browser's performance entry buffer with the given name. The application defined timestamp can be retrieved by one of the Performance interface's getEntries*() methods (getEntries(), getEntriesByName() or getEntriesByType()).

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

• entryType - set to "mark".
• name - set to the "name" given when the mark was created.
• startTime - set to the timestamp when mark() was called.
• duration - set to "0" (a mark has no duration).

If the name given to this method already exists in the PerformanceTiming interface, SyntaxError is thrown.

Syntax

performance.mark(name);

Arguments

name

A DOMString representing the name of the mark.

Return value

void

 

Example

The following example shows how mark() is used to create an application-defined peformance entry in the browser's performance entry buffer.

function create_mark(name) {
  if (performance.mark === undefined) {
    console.log("performance.mark Not supported");
    return;
  }
  // Create the performance mark
  performance.mark(name);
}

Specifications

Browser compatibility