Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

performance.now() — misurare il tempo trascorso

performance.now() restituisce un timestamp in millisecondi relativo all’origine temporale dell’ambiente. La differenza tra due letture consente di misurare il tempo trascorso senza risentire delle correzioni dell’orologio di sistema.

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

const start = performance.now();
// Run the operation being measured.
const elapsedMs = performance.now() - start;

performance.now() non accetta argomenti e restituisce un DOMHighResTimeStamp: un numero in millisecondi che può includere una parte frazionaria. Il valore è relativo all’origine temporale dell’ambiente, non all’epoca Unix. performance.timeOrigin descrive tale origine.

Per misurare il tempo trascorso, sottrai la lettura precedente da quella successiva nello stesso ambiente. L’orologio è monotono: le letture non diminuiscono a causa delle correzioni dell’orologio di sistema. Date.now(), invece, rappresenta il tempo di calendario e può risentire di tali correzioni. Non sottrarre direttamente letture provenienti da contesti con origini temporali diverse.

I browser possono ridurre la risoluzione per motivi di sicurezza; due letture consecutive possono essere uguali. Una parte frazionaria non garantisce una determinata precisione. L’esempio verifica il risultato del calcolo e che la durata non sia negativa, invece di un numero specifico di millisecondi.

Questa è una Web API definita da High Resolution Time, non una funzione del nucleo di ECMAScript. La specifica la rende disponibile in Window e Worker; verifica la disponibilità nel browser di destinazione, non in base alla versione di Node del repository. La sola lettura dell’orologio non registra una voce nella sequenza temporale delle prestazioni; User Timing fornisce misurazioni con nome tramite performance.mark() e performance.measure().

Esempi

const start = performance.now();
let sum = 0;
for (let i = 1; i <= 1000; i++) {
  sum += i;
}
const elapsedMs = performance.now() - start;
console.log(sum);
console.log(Number.isFinite(elapsedMs) && elapsedMs >= 0);

Risultato

500500
true

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