Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

performance.clearMarks() — usuwanie znaczników czasu

performance.clearMarks() usuwa znaczniki User Timing z bufora wpisów wydajności. Podanie nazwy usuwa wszystkie pasujące znaczniki; wywołanie bez argumentu usuwa wszystkie znaczniki, ale nie pomiary.

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

Składnia

performance.clearMarks();
performance.clearMarks(markName);

performance.clearMarks(markName) usuwa z bufora wpisów wydajności wszystkie obiekty PerformanceMark o dokładnie podanej nazwie, nie tylko najnowszy. Brak pasującego znacznika niczego nie zmienia. Metoda zwraca undefined, a nie liczbę usuniętych wpisów.

performance.clearMarks() bez argumentu usuwa wszystkie znaczniki. Nie usuwa wpisów PerformanceMeasure; służy do tego performance.clearMeasures(). Preferuj usuwanie według nazwy, aby nie kasować znaczników innych części aplikacji.

Utwórz pomiar przed usunięciem znaczników, do których odwołuje się on przez nazwę. Późniejsze performance.measure() używające usuniętej nazwy znacznika aplikacji zgłosi SyntaxError, chyba że znacznik zostanie utworzony ponownie. Istniejące pomiary pozostają w buforze.

To Web API określone przez User Timing, a nie funkcja konkretnej edycji ECMAScript; występuje już w User Timing Level 2. Specyfikacja nie jest tabelą zgodności przeglądarek. Sprawdź typeof globalThis.performance?.clearMarks === "function" w docelowym środowisku; obecność Node 24 w repozytorium nie potwierdza obsługi w przeglądarce.

Przykłady

(() => {
  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);
  }
})();

Wynik

2
0
true
0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła