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.