Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes