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.