CKTIS / JavaScript
performance.clearMeasures() — uklanjanje mjerenja User Timing
performance.clearMeasures() uklanja spremljena mjerenja User Timing iz međuspremnika unosa performansi. Možete ukloniti sva mjerenja ili sve unose s jednim nazivom, a da ne izbrišete vremenske oznake.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
performance.clearMeasures();
performance.clearMeasures(measureName);performance.clearMeasures() iz međuspremnika unosa performansi uklanja objekte PerformanceMeasure koje stvara performance.measure(). Bez argumenta uklanja sva mjerenja; performance.clearMeasures(measureName) uklanja sva mjerenja s tim točnim nazivom, a ne samo posljednje.
Neobavezni measureName naziv je vrste DOMString. Ako nema odgovarajućih mjerenja, poziv ne uklanja ništa. Povratna je vrijednost uvijek undefined, a ne broj uklonjenih unosa. Metoda ne uklanja unose PerformanceMark; za njih upotrijebite performance.clearMarks().
Uklonite vlastita mjerenja nakon što ih pročitate. U kodu koji dijeli stranicu s drugim modulima radije navedite naziv nego da metodu pozovete bez argumenta, kako ne biste uklonili mjerenja drugih modula. Primjer stvara dva mjerenja s istim nazivom i provjerava njihov broj prije i nakon uklanjanja, bez ispisivanja promjenjivih vremenskih vrijednosti.
Ovo je web API definiran u User Timingu, a ne značajka jezika ECMAScript. Metoda je navedena već u User Timing Level 2. Dostupnost provjerite u ciljnom pregledniku, primjerice pomoću typeof performance.clearMeasures === "function"; prisutnost Nodea 24 u repozitoriju ne potvrđuje podršku u pregledniku.
Primjeri
(() => {
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);
}
})();Rezultat
2 0 true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.