CKTIS / JavaScript
performance.measure — pojmenované časové intervaly
performance.measure zaznamenává pojmenovaný interval na časové ose výkonu. Může používat značky nebo explicitní časová razítka; moderní varianta vrací PerformanceMeasure se začátkem a délkou intervalu v milisekundách.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
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 patří do webového API User Timing, nikoli do ECMAScriptu. Zaznamenává položku typu "measure"; moderní varianta vrací PerformanceMeasure s hodnotami name, startTime, duration a detail. Předanou funkci nespouští ani automaticky neměří její dobu běhu.
performance.measure(name) pokrývá interval od nuly na časové ose výkonu až do okamžiku volání. Varianta s názvy značek používá poslední odpovídající performance.mark. Objekt možností přijímá start a end jako názvy značek nebo časová razítka v milisekundách relativní k počátku časové osy výkonu, nikoli k unixové epoše. Lze zadat start spolu s duration nebo end spolu s duration, nikoli však všechna tři pole současně.
Prázdný objekt možností je povolen. Neprázdný objekt musí obsahovat start nebo end a vylučuje třetí argument; porušení těchto pravidel vyvolá TypeError. Pokud chybí běžná pojmenovaná značka, vyvolá se SyntaxError. Záporné vstupní časové razítko vyvolá TypeError, výsledná duration však může být záporná. detail se kopíruje pomocí strukturovaného klonování.
Příklad používá umělá časová razítka: ukazuje výpočet intervalu, nikoli měření rychlosti. performance.clearMeasures(name) odstraní uložená měření s daným názvem, nikoli však značky. Objekt možností a vrácená položka pocházejí z rozšíření úrovně 3; úroveň 2 vracela undefined. Samotná přítomnost metody ani Node 24 nedokazuje podporu této varianty v cílovém prohlížeči.
Pří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ýsledek
measure: 10 + 25 ms
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.