CKTIS / JavaScript
performance.clearMeasures() — odstranění měření User Timing
performance.clearMeasures() odstraňuje uložená měření User Timing z vyrovnávací paměti položek výkonu. Můžete odstranit všechna měření nebo všechny položky s jedním názvem, aniž byste smazali časové značky.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
performance.clearMeasures();
performance.clearMeasures(measureName);performance.clearMeasures() odstraňuje z vyrovnávací paměti položek výkonu objekty PerformanceMeasure vytvořené metodou performance.measure(). Bez argumentu odstraní všechna měření; performance.clearMeasures(measureName) odstraní všechna měření s přesně tímto názvem, nejen to poslední.
Volitelný measureName je název typu DOMString. Pokud žádná měření neodpovídají, volání nic neodstraní. Návratová hodnota je vždy undefined, nikoli počet odstraněných položek. Metoda neodstraňuje položky PerformanceMark; k tomu slouží performance.clearMarks().
Po přečtení odstraňte vlastní měření. V kódu, který sdílí stránku s jinými moduly, raději předávejte název, než abyste metodu volali bez argumentu; předejdete tak odstranění měření jiných modulů. Příklad vytvoří dvě měření se stejným názvem a ověří jejich počet před odstraněním a po něm, aniž by vypisoval proměnné časové hodnoty.
Jde o Web API specifikované standardem User Timing, nikoli o funkci jazyka ECMAScript. Metoda je uvedena už v User Timing Level 2. Dostupnost ověřte v cílovém prohlížeči, například pomocí typeof performance.clearMeasures === "function"; přítomnost Node 24 v repozitáři nepotvrzuje podporu v prohlížeči.
Pří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ýsledek
2 0 true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.