Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori