WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

performance.clearMarks() — Zeitmarken entfernen

performance.clearMarks() entfernt User-Timing-Marken aus dem Performance-Eintragspuffer. Mit einem Namen werden alle passenden Marken entfernt; ohne Argument werden alle Marken, aber keine Messungen entfernt.

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.clearMarks();
performance.clearMarks(markName);

performance.clearMarks(markName) entfernt alle PerformanceMark-Objekte mit genau dem angegebenen Namen aus dem Performance-Eintragspuffer, nicht nur das neueste. Gibt es keine passende Marke, ändert sich nichts. Die Methode gibt undefined zurück, nicht die Anzahl der entfernten Einträge.

performance.clearMarks() ohne Argument entfernt alle Marken. PerformanceMeasure-Einträge werden dadurch nicht entfernt; verwende dafür performance.clearMeasures(). Entferne Marken möglichst nach Namen, damit du nicht die Marken anderer Anwendungskomponenten löschst.

Erstelle eine Messung, bevor du die Marken löschst, auf die sie über ihren Namen verweist. Ein späterer Aufruf von performance.measure() mit dem Namen einer gelöschten Anwendungsmarke löst SyntaxError aus, sofern die Marke nicht erneut erstellt wird. Bereits vorhandene Messungen bleiben im Puffer.

Dies ist eine durch User Timing spezifizierte Web-API und keine Funktion einer bestimmten ECMAScript-Ausgabe; sie ist bereits in User Timing Level 2 enthalten. Die Spezifikation ist keine Browser-Kompatibilitätstabelle. Prüfe typeof globalThis.performance?.clearMarks === "function" in der Zielumgebung; Node 24 in einem Repository belegt keine Browserunterstützung.

Beispiele

(() => {
  const name = "cktis:clearMarks:demo";
  performance.clearMarks(name);
  try {
    performance.mark(name);
    performance.mark(name);
    console.log(performance.getEntriesByName(name, "mark").length);
    const result = performance.clearMarks(name);
    console.log(performance.getEntriesByName(name, "mark").length);
    console.log(result === undefined);
    performance.clearMarks(name);
    console.log(performance.getEntriesByName(name, "mark").length);
  } finally {
    performance.clearMarks(name);
  }
})();

Ergebnis

2
0
true
0

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