CKTIS / JavaScript
performance.now() — medir o tempo decorrido
performance.now() devolve uma marca temporal em milissegundos, relativa à origem temporal do ambiente. A diferença entre duas leituras permite medir o tempo decorrido sem ser afetada por ajustes do relógio do sistema.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
const start = performance.now();
// Run the operation being measured.
const elapsedMs = performance.now() - start;performance.now() não recebe argumentos e devolve um DOMHighResTimeStamp: um número em milissegundos que pode incluir uma parte fracionária. O valor é relativo à origem temporal do ambiente, não à época Unix. performance.timeOrigin descreve essa origem.
Para medir o tempo decorrido, subtrai a leitura anterior à leitura posterior, no mesmo ambiente. O relógio é monotónico: as leituras não diminuem devido a ajustes do relógio do sistema. Em contrapartida, Date.now() representa o tempo de calendário e pode ser afetado por esses ajustes. Não subtraias diretamente leituras de contextos com origens temporais diferentes.
Os navegadores podem reduzir a resolução por motivos de segurança; duas leituras consecutivas podem ser iguais. Uma parte fracionária não garante uma determinada precisão. O exemplo verifica o resultado do cálculo e uma duração não negativa, em vez de um número específico de milissegundos.
Esta é uma API Web definida por High Resolution Time, não uma função do núcleo de ECMAScript. A especificação disponibiliza-a em Window e Worker; verifica a disponibilidade no navegador de destino, não com base na versão de Node do repositório. A leitura do relógio, por si só, não regista uma entrada na linha temporal de desempenho; User Timing disponibiliza medições com nome através de performance.mark() e performance.measure().
Exemplos
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);Resultado
500500 true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.