База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници