Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

performance.clearMeasures() — odstranjevanje meritev User Timing

performance.clearMeasures() odstrani shranjene meritve User Timing iz medpomnilnika vnosov zmogljivosti. Odstranite lahko vse meritve ali vse vnose z enim določenim imenom, ne da bi izbrisali časovne oznake.

Različica: 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 medpomnilnika vnosov zmogljivosti odstrani objekte PerformanceMeasure, ki jih ustvari performance.measure(). Brez argumenta odstrani vse meritve; performance.clearMeasures(measureName) odstrani vse meritve s točno tem imenom, ne le zadnje.

Izbirni measureName je ime vrste DOMString. Če ni ustreznih meritev, klic ne odstrani ničesar. Vrnjena vrednost je vedno undefined, ne število odstranjenih vnosov. Metoda ne odstrani vnosov PerformanceMark; za to uporabite performance.clearMarks().

Ko preberete svoje meritve, jih odstranite. V kodi, ki si stran deli z drugimi moduli, raje podajte ime, kot da metodo pokličete brez argumenta, da ne izbrišete meritev drugih modulov. Primer ustvari dve meritvi z istim imenom in preveri njihovo število pred odstranitvijo in po njej, ne da bi izpisal spremenljive časovne vrednosti.

To je spletni API, določen v User Timing, in ne funkcija jezika ECMAScript. Metoda je vključena že v User Timing Level 2. Razpoložljivost preverite v ciljnem brskalniku, na primer z typeof performance.clearMeasures === "function"; prisotnost Node 24 v repozitoriju ne potrjuje podpore v brskalniku.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri