Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

performance.measure — intervalles de temps nommés

performance.measure enregistre un intervalle nommé sur la chronologie des performances. Il peut utiliser des marques ou des horodatages explicites ; la surcharge moderne renvoie un PerformanceMeasure contenant le début et la durée de l’intervalle en millisecondes.

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

performance.measure(name)
performance.measure(name, startMark, endMark)
performance.measure(name, { start, end, detail })
performance.measure(name, { start, duration, detail })
performance.measure(name, { end, duration, detail })

performance.measure fait partie de l’API Web User Timing, et non d’ECMAScript. Il enregistre une entrée de type "measure" ; la surcharge moderne renvoie un PerformanceMeasure avec name, startTime, duration et detail. Il n’exécute pas une fonction fournie et ne la chronomètre pas automatiquement.

performance.measure(name) couvre l’intervalle allant de zéro sur la chronologie des performances jusqu’à l’appel. La surcharge utilisant des noms de marques prend la dernière performance.mark correspondante. L’objet d’options accepte start et end sous forme de noms de marques ou d’horodatages en millisecondes relatifs à l’origine temporelle des performances, et non à l’époque Unix. Vous pouvez fournir start avec duration, ou end avec duration, mais pas les trois champs ensemble.

Un objet d’options vide est autorisé. Un objet non vide doit contenir start ou end et exclut un troisième argument ; enfreindre ces règles déclenche un TypeError. L’absence d’une marque nommée ordinaire déclenche un SyntaxError. Un horodatage d’entrée négatif déclenche un TypeError, mais la duration obtenue peut être négative. detail est copié au moyen du clonage structuré.

L’exemple utilise des horodatages artificiels : il montre le calcul d’un intervalle, pas un test de vitesse. performance.clearMeasures(name) supprime les mesures enregistrées portant ce nom, mais pas les marques. L’objet d’options et l’entrée renvoyée proviennent des extensions de niveau 3 ; le niveau 2 renvoyait undefined. La seule présence de la méthode, pas plus que Node 24, ne prouve la prise en charge de cette surcharge dans un navigateur donné.

Exemples

(() => {
  const name = "cktis:measure-demo";
  try {
    const entry = performance.measure(name, { start: 10, end: 35 });
    console.log(`${entry.entryType}: ${entry.startTime} + ${entry.duration} ms`);
  } finally {
    performance.clearMeasures(name);
  }
})();

Résultat

measure: 10 + 25 ms

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.

Sources