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

CKTIS / JavaScript

performance.measure — poimenovani časovni intervali

performance.measure zabeleži poimenovani interval na časovnici zmogljivosti. Uporablja lahko oznake ali izrecne časovne žige; sodobna različica vrne PerformanceMeasure z začetkom in trajanjem intervala v milisekundah.

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.measure(name)
performance.measure(name, startMark, endMark)
performance.measure(name, { start, end, detail })
performance.measure(name, { start, duration, detail })
performance.measure(name, { end, duration, detail })

performance.measure spada v spletni API User Timing, ne v ECMAScript. Zabeleži vnos vrste "measure"; sodobna različica vrne PerformanceMeasure z vrednostmi name, startTime, duration in detail. Posredovane funkcije ne izvede in samodejno ne meri njenega izvajanja.

performance.measure(name) zajema interval od ničle na časovnici zmogljivosti do klica. Različica z imeni oznak uporabi najnovejši ustrezni performance.mark. Predmet možnosti sprejema start in end kot imeni oznak ali časovna žiga v milisekundah glede na časovni izvor zmogljivosti, ne glede na Unixovo epoho. Podate lahko start skupaj z duration ali end skupaj z duration, ne pa vseh treh polj hkrati.

Prazen predmet možnosti je dovoljen. Neprazen mora vsebovati start ali end in izključuje tretji argument; kršitev teh pravil povzroči TypeError. Če običajna poimenovana oznaka manjka, se sproži SyntaxError. Negativen vhodni časovni žig povzroči TypeError, vendar je lahko rezultat duration negativen. detail se kopira s strukturiranim kloniranjem.

Primer uporablja umetne časovne žige: prikazuje izračun intervala, ne preizkusa hitrosti. performance.clearMeasures(name) odstrani shranjene meritve s tem imenom, ne pa oznak. Predmet možnosti in vrnjeni vnos izvirata iz razširitev ravni 3; raven 2 je vračala undefined. Zgolj prisotnost metode, prav tako pa tudi Node 24, ne dokazuje podpore za to različico v ciljnem brskalniku.

Primeri

(() => {
  const name = "cktis:measure-demo";
  try {
    const entry = performance.measure(name, { start: 10, end: 35 });
    console.log(`${entry.entryType}: ${entry.startTime} + ${entry.duration} ms`);
  } finally {
    performance.clearMeasures(name);
  }
})();

Rezultat

measure: 10 + 25 ms

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

Viri