Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

performance.now() — medir el tiempo transcurrido

performance.now() devuelve una marca de tiempo en milisegundos relativa al origen temporal del entorno. La diferencia entre dos lecturas permite medir el tiempo transcurrido sin que le afecten los ajustes del reloj del sistema.

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

Sintaxis

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

performance.now() no recibe argumentos y devuelve un DOMHighResTimeStamp: un número en milisegundos que puede incluir una parte fraccionaria. El valor es relativo al origen temporal del entorno, no a la época Unix. performance.timeOrigin describe ese origen.

Para medir el tiempo transcurrido, resta la lectura anterior de la posterior en el mismo entorno. El reloj es monótono: las lecturas no disminuyen debido a los ajustes del reloj del sistema. En cambio, Date.now() representa el tiempo del calendario y esos ajustes pueden afectarle. No restes directamente lecturas de contextos con distintos orígenes temporales.

Los navegadores pueden reducir la resolución por motivos de seguridad; dos lecturas consecutivas pueden ser iguales. Una parte fraccionaria no garantiza una precisión determinada. El ejemplo comprueba el resultado del cálculo y que la duración no sea negativa, en lugar de un número concreto de milisegundos.

Esta es una API web definida por High Resolution Time, no una función del núcleo de ECMAScript. La especificación la ofrece en Window y Worker; comprueba su disponibilidad en el navegador de destino, no a partir de la versión de Node del repositorio. Leer el reloj por sí solo no registra una entrada en la línea de tiempo de rendimiento; User Timing ofrece mediciones con nombre mediante performance.mark() y performance.measure().

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes