Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

performance.measure — pomenované časové intervaly

performance.measure zaznamenáva pomenovaný interval na časovej osi výkonu. Môže používať značky alebo explicitné časové značky; moderný variant vracia PerformanceMeasure so začiatkom a trvaním intervalu v milisekundách.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

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 patrí do webového API User Timing, nie do ECMAScriptu. Zaznamenáva položku typu "measure"; moderný variant vracia PerformanceMeasure s hodnotami name, startTime, duration a detail. Odovzdanú funkciu nespúšťa ani automaticky nemeria jej trvanie.

performance.measure(name) pokrýva interval od nuly na časovej osi výkonu až po okamih volania. Variant s názvami značiek používa posledný zodpovedajúci performance.mark. Objekt možností prijíma start a end ako názvy značiek alebo časové značky v milisekundách relatívne k počiatku časovej osi výkonu, nie k unixovej epoche. Možno zadať start spolu s duration alebo end spolu s duration, nie však všetky tri polia naraz.

Prázdny objekt možností je povolený. Neprázdny objekt musí obsahovať start alebo end a vylučuje tretí argument; porušenie týchto pravidiel vyvolá TypeError. Ak chýba bežná pomenovaná značka, vyvolá sa SyntaxError. Záporná vstupná časová značka vyvolá TypeError, výsledné duration však môže byť záporné. detail sa kopíruje pomocou štruktúrovaného klonovania.

Príklad používa umelé časové značky: ukazuje výpočet intervalu, nie meranie rýchlosti. performance.clearMeasures(name) odstráni uložené merania s daným názvom, nie však značky. Objekt možností a vrátená položka pochádzajú z rozšírení úrovne 3; úroveň 2 vracala undefined. Samotná prítomnosť metódy ani Node 24 nedokazuje podporu tohto variantu v cieľovom prehliadači.

Príklady

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

Výsledok

measure: 10 + 25 ms

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje