Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

performance.clearMeasures() — odstránenie meraní User Timing

performance.clearMeasures() odstraňuje uložené merania User Timing z vyrovnávacej pamäte položiek výkonu. Môžete odstrániť všetky merania alebo všetky položky s jedným názvom bez toho, aby ste vymazali časové značky.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

performance.clearMeasures();
performance.clearMeasures(measureName);

performance.clearMeasures() odstraňuje z vyrovnávacej pamäte položiek výkonu objekty PerformanceMeasure vytvorené metódou performance.measure(). Bez argumentu odstráni všetky merania; performance.clearMeasures(measureName) odstráni všetky merania s presne týmto názvom, nielen to posledné.

Voliteľný measureName je názov typu DOMString. Ak sa nenájdu zodpovedajúce merania, volanie nič neodstráni. Návratová hodnota je vždy undefined, nie počet odstránených položiek. Metóda neodstraňuje položky PerformanceMark; na to slúži performance.clearMarks().

Po prečítaní odstráňte vlastné merania. V kóde, ktorý zdieľa stránku s inými modulmi, radšej odovzdajte názov, než aby ste metódu volali bez argumentu, aby ste neodstránili merania iných modulov. Príklad vytvorí dve merania s rovnakým názvom a skontroluje ich počet pred odstránením a po ňom bez vypisovania meniacich sa časových hodnôt.

Ide o Web API špecifikované štandardom User Timing, nie o funkciu jazyka ECMAScript. Metóda je uvedená už v User Timing Level 2. Dostupnosť overte v cieľovom prehliadači, napríklad pomocou typeof performance.clearMeasures === "function"; prítomnosť Node 24 v repozitári nepotvrdzuje podporu v prehliadači.

Príklady

(() => {
  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);
  }
})();

Výsledok

2
0
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje