CKTIS / JavaScript
performance.measure — именувани времеви интервали
performance.measure записва именуван интервал във времевата линия на производителността. Може да използва маркери или изрични времеви отметки; съвременният вариант връща PerformanceMeasure с началото и продължителността на интервала в милисекунди.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
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 принадлежи към уеб API User Timing, а не към ECMAScript. То записва запис от тип "measure"; съвременният вариант връща PerformanceMeasure с name, startTime, duration и detail. Не изпълнява подадена функция и не измерва автоматично времето ѝ на изпълнение.
performance.measure(name) обхваща интервала от нулата на времевата линия на производителността до момента на извикването. Вариантът с имена на маркери използва най-новия съвпадащ performance.mark. Обектът с опции приема start и end като имена на маркери или времеви отметки в милисекунди спрямо времевия произход на производителността, а не спрямо Unix епохата. Може да зададете start с duration или end с duration, но не и трите полета едновременно.
Празен обект с опции е допустим. Непразният трябва да съдържа start или end и изключва трети аргумент; нарушаването на тези правила предизвиква TypeError. Ако липсва обикновен именуван маркер, се предизвиква SyntaxError. Отрицателна входна времева отметка предизвиква TypeError, но получената duration може да е отрицателна. detail се копира чрез структурирано клониране.
Примерът използва изкуствени времеви отметки: показва изчисляване на интервал, а не тест за скорост. performance.clearMeasures(name) премахва запазените измервания с това име, но не и маркерите. Обектът с опции и върнатият запис идват от разширенията на ниво 3; ниво 2 връщаше undefined. Нито самото наличие на метода, нито Node 24 доказват поддръжка на този вариант в целевия браузър.
Примери
(() => {
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);
}
})();Резултат
measure: 10 + 25 ms
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.