CKTIS / JavaScript
performance.clearMeasures() — User-Timing-Messungen entfernen
performance.clearMeasures() entfernt gespeicherte User-Timing-Messungen aus dem Performance-Eintragspuffer. Sie können alle Messungen oder alle Einträge mit einem bestimmten Namen entfernen, ohne Zeitmarken zu löschen.
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.clearMeasures();
performance.clearMeasures(measureName);performance.clearMeasures() entfernt PerformanceMeasure-Objekte, die durch performance.measure() erstellt wurden, aus dem Performance-Eintragspuffer. Ohne Argument entfernt die Methode alle Messungen; performance.clearMeasures(measureName) entfernt jede Messung mit genau diesem Namen, nicht nur die letzte.
Das optionale measureName ist ein Name vom Typ DOMString. Wenn keine Messungen übereinstimmen, wird nichts entfernt. Der Rückgabewert ist immer undefined, nicht die Anzahl der gelöschten Einträge. Die Methode entfernt keine PerformanceMark-Einträge; dafür gibt es performance.clearMarks().
Entfernen Sie Ihre eigenen Messungen, nachdem Sie sie ausgelesen haben. In Code, der eine Seite mit anderen teilt, sollten Sie lieber einen Namen übergeben, statt die Methode ohne Argument aufzurufen, damit keine Messungen anderer Module gelöscht werden. Das Beispiel erstellt zwei Messungen mit demselben Namen und prüft ihre Anzahl vor und nach dem Entfernen, ohne variable Zeitwerte auszugeben.
Dies ist eine durch User Timing spezifizierte Web API und kein Merkmal der ECMAScript-Sprache. Die Methode ist bereits in User Timing Level 2 enthalten. Prüfen Sie die Verfügbarkeit im Zielbrowser, zum Beispiel mit typeof performance.clearMeasures === "function"; dass Node 24 in einem Repository vorhanden ist, belegt keine Browserunterstützung.
Beispiele
(() => {
const name = "cktis.clearMeasures.demo";
performance.clearMeasures(name);
try {
performance.measure(name);
performance.measure(name);
console.log(performance.getEntriesByName(name, "measure").length);
const result = performance.clearMeasures(name);
console.log(performance.getEntriesByName(name, "measure").length);
console.log(result === undefined);
} finally {
performance.clearMeasures(name);
}
})();Ergebnis
2 0 true
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.