CKTIS / JavaScript
performance.now() — mesurer le temps écoulé
performance.now() renvoie un horodatage en millisecondes relatif à l’origine temporelle de l’environnement. La différence entre deux lectures permet de mesurer le temps écoulé sans être affectée par les ajustements de l’horloge système.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const start = performance.now();
// Run the operation being measured.
const elapsedMs = performance.now() - start;performance.now() ne prend aucun argument et renvoie un DOMHighResTimeStamp : un nombre en millisecondes qui peut comporter une partie fractionnaire. La valeur est relative à l’origine temporelle de l’environnement, et non à l’époque Unix. performance.timeOrigin décrit cette origine.
Pour mesurer le temps écoulé, soustrayez la lecture précédente de la lecture suivante, dans le même environnement. L’horloge est monotone : les lectures ne diminuent pas à cause des ajustements de l’horloge système. En revanche, Date.now() représente le temps calendaire et peut être affecté par ces ajustements. Ne soustrayez pas directement des lectures provenant de contextes dont les origines temporelles diffèrent.
Les navigateurs peuvent réduire la résolution pour des raisons de sécurité ; deux lectures consécutives peuvent être égales. Une partie fractionnaire ne garantit pas une précision particulière. L’exemple vérifie le résultat du calcul et une durée non négative, plutôt qu’un nombre précis de millisecondes.
Il s’agit d’une API Web définie par High Resolution Time, et non d’une fonction du cœur d’ECMAScript. La spécification la rend disponible dans Window et Worker ; vérifiez sa disponibilité dans le navigateur cible, et non à partir de la version de Node du dépôt. La simple lecture de l’horloge n’enregistre pas d’entrée dans la chronologie des performances ; User Timing fournit des mesures nommées avec performance.mark() et performance.measure().
Exemples
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);Résultat
500500 true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.