CKTIS / JavaScript
performance.clearMarks() — премахване на времеви маркери
performance.clearMarks() премахва маркерите User Timing от буфера със записи за производителността. При зададено име премахва всички съвпадащи маркери; без аргумент премахва всички маркери, но не и измерванията.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
performance.clearMarks();
performance.clearMarks(markName);performance.clearMarks(markName) премахва от буфера със записи за производителността всички обекти PerformanceMark с точно зададеното име, а не само най-новия. Ако няма съвпадащ маркер, нищо не се променя. Методът връща undefined, а не броя на премахнатите записи.
performance.clearMarks() без аргумент премахва всички маркери. Той не премахва записите PerformanceMeasure; за тях използвайте performance.clearMeasures(). Предпочитайте премахването по име, за да не изтривате маркери, принадлежащи на други компоненти на приложението.
Създайте измерване, преди да премахнете маркерите, към които то се отнася по име. Последващо извикване на performance.measure(), което използва името на премахнат маркер на приложението, хвърля SyntaxError, освен ако маркерът не бъде създаден отново. Съществуващите измервания остават в буфера.
Това е уеб API, специфициран от User Timing, а не функция на конкретно издание на ECMAScript; присъства още в User Timing Level 2. Спецификацията не е таблица за съвместимост на браузърите. Проверете typeof globalThis.performance?.clearMarks === "function" в целевата среда; наличието на Node 24 в хранилище не доказва поддръжка в браузърите.
Примери
(() => {
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);
}
})();Резултат
2 0 true 0
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.