База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници