Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

performance.clearMeasures() — usuwanie pomiarów User Timing

Metoda performance.clearMeasures() usuwa zapisane pomiary User Timing z bufora wpisów wydajności. Możesz usunąć wszystkie pomiary albo wszystkie wpisy o jednej nazwie, nie usuwając znaczników czasu.

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.clearMeasures();
performance.clearMeasures(measureName);

performance.clearMeasures() usuwa z bufora wpisów wydajności obiekty PerformanceMeasure, tworzone przez performance.measure(). Bez argumentu usuwa wszystkie pomiary; performance.clearMeasures(measureName) usuwa wszystkie pomiary o dokładnie podanej nazwie, a nie tylko ostatni.

Opcjonalny measureName jest nazwą typu DOMString. Jeśli nie ma pasujących pomiarów, wywołanie niczego nie usuwa. Wynikiem jest zawsze undefined, a nie liczba usuniętych wpisów. Metoda nie usuwa znaczników PerformanceMark; służy do tego performance.clearMarks().

Usuwaj własne pomiary po ich odczytaniu. W kodzie współdzielącym stronę preferuj nazwę zamiast wywołania bez argumentu, aby nie usuwać pomiarów innych modułów. Przykład tworzy dwa pomiary o tej samej nazwie i sprawdza ich liczbę przed usunięciem i po nim, bez wypisywania zmiennych czasów.

To Web API określone w User Timing, nie funkcja języka ECMAScript. Metoda występuje już w User Timing Level 2. Dostępność sprawdzaj w docelowej przeglądarce, np. przez typeof performance.clearMeasures === "function"; obecność Node 24 w repozytorium nie potwierdza obsługi w przeglądarce.

Przykłady

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

Wynik

2
0
true

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

Źródła