PerformanceMark: PerformanceMark() Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Der PerformanceMark() Konstruktor erzeugt einen timestamp mit dem angegebenen Namen.

Im Gegensatz zu performance.mark() werden Performance-Marken, die durch den Konstruktor erstellt werden, nicht zur Leistungstimeline des Browsers hinzugefügt. Das bedeutet, dass Aufrufe der getEntries*() Methoden der Performance-Schnittstelle (getEntries(), getEntriesByName() oder getEntriesByType()) keine Einträge für diese Marken anzeigen.

Syntax

js
new PerformanceMark(name)
new PerformanceMark(name, markOptions)

Parameter

name

Ein String, der den Namen der Marke darstellt.

markOptions Optional

Ein Objekt zur Angabe eines Zeitstempels und zusätzlicher Metadaten für die Marke.

detail Optional

Beliebige Metadaten, die in die Marke einbezogen werden sollen. Standard ist null.

startTime Optional

DOMHighResTimeStamp, der als Markierungszeit verwendet werden soll. Standard ist performance.now().

Rückgabewert

Ein PerformanceMark-Objekt.

Ausnahmen

  • SyntaxError: Wird ausgelöst, wenn der name, der dieser Methode übergeben wird, bereits in der PerformanceTiming-Schnittstelle existiert.
  • TypeError: Wird ausgelöst, wenn startTime negativ ist.

Beispiele

Das folgende Beispiel zeigt, wie PerformanceMark-Einträge erstellt werden und dann nicht Teil der Leistungstimeline des Browsers sind.

js
new PerformanceMark("squirrel");
new PerformanceMark("monkey");
new PerformanceMark("dog");

const allEntries = performance.getEntriesByType("mark");
console.log(allEntries.length);
// 0

Spezifikationen

Specification
User Timing
# dom-performancemark-constructor

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch