WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

performance.measure — benannte Zeitintervalle

performance.measure zeichnet ein benanntes Intervall auf der Performance-Zeitachse auf. Dabei können Markierungen oder explizite Zeitstempel verwendet werden; die moderne Überladung gibt ein PerformanceMeasure mit Startzeit und Dauer des Intervalls in Millisekunden zurück.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

performance.measure(name)
performance.measure(name, startMark, endMark)
performance.measure(name, { start, end, detail })
performance.measure(name, { start, duration, detail })
performance.measure(name, { end, duration, detail })

performance.measure gehört zur Web API User Timing, nicht zu ECMAScript. Es zeichnet einen Eintrag vom Typ "measure" auf; die moderne Überladung gibt ein PerformanceMeasure mit name, startTime, duration und detail zurück. Die Methode führt eine übergebene Funktion nicht aus und misst sie auch nicht automatisch.

performance.measure(name) umfasst den Zeitraum ab dem Nullpunkt der Performance-Zeitachse bis zum Aufruf. Die Überladung mit Markierungsnamen verwendet die neueste passende performance.mark. Das Optionsobjekt akzeptiert start und end als Markierungsnamen oder Zeitstempel in Millisekunden relativ zum Performance-Zeitursprung, nicht zur Unix-Epoche. Sie können start zusammen mit duration oder end zusammen mit duration angeben, aber nicht alle drei Felder zugleich.

Ein leeres Optionsobjekt ist zulässig. Ein nicht leeres muss start oder end enthalten und schließt ein drittes Argument aus; bei Verstößen wird ein TypeError ausgelöst. Fehlt eine gewöhnliche benannte Markierung, wird ein SyntaxError ausgelöst. Ein negativer Eingabezeitstempel löst einen TypeError aus, die resultierende duration kann jedoch negativ sein. detail wird durch strukturiertes Klonen kopiert.

Das Beispiel verwendet künstliche Zeitstempel: Es veranschaulicht die Berechnung eines Intervalls, keinen Geschwindigkeitstest. performance.clearMeasures(name) entfernt gespeicherte Messungen mit diesem Namen, aber keine Markierungen. Das Optionsobjekt und der zurückgegebene Eintrag stammen aus Erweiterungen von Level 3; Level 2 gab undefined zurück. Weder das bloße Vorhandensein der Methode noch Node 24 beweisen, dass diese Überladung im Zielbrowser unterstützt wird.

Beispiele

(() => {
  const name = "cktis:measure-demo";
  try {
    const entry = performance.measure(name, { start: 10, end: 35 });
    console.log(`${entry.entryType}: ${entry.startTime} + ${entry.duration} ms`);
  } finally {
    performance.clearMeasures(name);
  }
})();

Ergebnis

measure: 10 + 25 ms

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen