WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

PerformanceEntry.duration — Dauer eines Performance-Eintrags

PerformanceEntry.duration ist eine schreibgeschützte Eigenschaft, die die Dauer eines Performance-Eintrags in Millisekunden angibt. Ihre Bedeutung hängt von entryType ab; ein Wert von 0 kann bedeuten, dass eine Dauer nicht zutrifft, und nicht, dass ein Vorgang sofort abgeschlossen wurde.

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

entry.duration

PerformanceEntry.duration wird als entry.duration gelesen, ohne eine Methode aufzurufen. Die Eigenschaft gibt einen DOMHighResTimeStamp zurück: eine Zahl in Millisekunden, die auch einen Nachkommaanteil enthalten kann. Es handelt sich um eine Dauer, nicht um ein Datum oder einen Startzeitpunkt. Die Eigenschaft ist schreibgeschützt.

Ihre Bedeutung hängt von entryType ab. Bei measure ist sie die Länge der Messung, bei resource gilt responseEnd - startTime und bei navigation loadEventEnd - startTime. Bei Einträgen wie mark und paint ist eine Dauer nicht anwendbar und beträgt 0. Werte von null sollten daher nicht grundsätzlich als Hinweis auf eine schnelle Ausführung verstanden werden.

Einträge sind Objekte spezialisierter Schnittstellen, die von PerformanceEntry erben. Dies ist eine Webplattform-API und keine Funktion von ECMAScript selbst. Die Eigenschaft wird von Browsern weitgehend unterstützt und ist in Web Workers verfügbar. Das bedeutet jedoch nicht, dass jeder Eintragstyp oder jede Variante der APIs zum Erstellen von Einträgen unterstützt wird.

Das Beispiel erstellt ein PerformanceMeasure mit den expliziten Werten start: 10 und end: 35. Das Lesen von entry.duration ergibt unabhängig von der Gerätegeschwindigkeit 25. Dies sind synthetische Werte und keine Messung der Codeausführung; nach dem Auslesen entfernt das Beispiel die benannte Messung aus der Zeitleiste.

Beispiele

const entry = performance.measure("cktis-duration-demo", {
  start: 10,
  end: 35,
});
console.log(entry.entryType);
console.log(entry.duration);
performance.clearMeasures("cktis-duration-demo");

Ergebnis

measure
25

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