CKTIS / JavaScript
performance.clearMeasures() — премахване на измерванията от User Timing
performance.clearMeasures() премахва съхранените измервания от 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.clearMeasures();
performance.clearMeasures(measureName);performance.clearMeasures() премахва от буфера с записи за производителност обектите PerformanceMeasure, създадени чрез performance.measure(). Без аргумент методът премахва всички измервания; performance.clearMeasures(measureName) премахва всички измервания с точно това име, а не само последното.
Незадължителният measureName е име от тип DOMString. Ако няма съвпадащи измервания, извикването не премахва нищо. Върнатата стойност винаги е undefined, а не броят на изтритите записи. Методът не премахва записи PerformanceMark; за тях използвайте performance.clearMarks().
Премахвайте собствените си измервания, след като ги прочетете. В код, който споделя страница с други модули, предпочитайте да подадете име, вместо да извиквате метода без аргумент, за да не изтриете измерванията на други модули. Примерът създава две измервания с едно и също име и проверява броя им преди и след премахването, без да извежда променливи стойности за време.
Това е Web API, специфициран от User Timing, а не функция на езика ECMAScript. Методът е включен още в User Timing Level 2. Проверете наличността му в целевия браузър, например с typeof performance.clearMeasures === "function"; наличието на Node 24 в хранилище не доказва поддръжка в браузъра.
Примери
(() => {
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);
}
})();Резултат
2 0 true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.