Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

performance.measure — intervalli di tempo con nome

performance.measure registra un intervallo con nome sulla linea temporale delle prestazioni. Può usare marcatori o timestamp espliciti; la versione moderna restituisce un PerformanceMeasure con l’inizio e la durata dell’intervallo in millisecondi.

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

Sintassi

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 appartiene alla Web API User Timing, non a ECMAScript. Registra una voce di tipo "measure"; la versione moderna restituisce un PerformanceMeasure con name, startTime, duration e detail. Non esegue né misura automaticamente una funzione passata come argomento.

performance.measure(name) copre l’intervallo da zero sulla linea temporale delle prestazioni fino al momento della chiamata. La versione con nomi di marcatori usa l’ultimo performance.mark corrispondente. L’oggetto delle opzioni accetta start e end come nomi di marcatori o timestamp in millisecondi relativi all’origine temporale delle prestazioni, non all’epoca Unix. È possibile specificare start con duration oppure end con duration, ma non tutti e tre i campi insieme.

È consentito un oggetto delle opzioni vuoto. Se non è vuoto, deve contenere start o end e non ammette un terzo argomento; la violazione di queste regole genera un TypeError. Se manca un normale marcatore con nome, viene generato un SyntaxError. Un timestamp di input negativo genera un TypeError, ma la duration risultante può essere negativa. detail viene copiato tramite clonazione strutturata.

L’esempio usa timestamp artificiali: mostra il calcolo di un intervallo, non un test di velocità. performance.clearMeasures(name) rimuove le misurazioni memorizzate con quel nome, ma non i marcatori. L’oggetto delle opzioni e la voce restituita provengono dalle estensioni di livello 3; il livello 2 restituiva undefined. La sola presenza del metodo, così come Node 24, non dimostra che questa versione sia supportata nel browser di destinazione.

Esempi

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

Risultato

measure: 10 + 25 ms

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti