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

Specification	Status	Comment
User Timing The definition of 'mark()' in that specification.	Editor's Draft	Clarifies mark() processing model.
User Timing The definition of 'mark()' in that specification.	Recommendation	Basic definition.

Browser compatibility