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.