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

CKTIS / JavaScript

performance.clearMeasures() — supprimer des mesures User Timing

performance.clearMeasures() supprime les mesures User Timing enregistrées dans le tampon des entrées de performance. Vous pouvez supprimer toutes les mesures ou toutes celles portant un nom donné, sans supprimer les marqueurs temporels.

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.clearMeasures();
performance.clearMeasures(measureName);

performance.clearMeasures() supprime du tampon des entrées de performance les objets PerformanceMeasure créés par performance.measure(). Sans argument, la méthode supprime toutes les mesures ; performance.clearMeasures(measureName) supprime toutes celles qui portent exactement ce nom, et pas seulement la plus récente.

L’argument facultatif measureName est un nom de type DOMString. Si aucune mesure ne correspond, l’appel ne supprime rien. La valeur de retour est toujours undefined, et non le nombre d’entrées supprimées. La méthode ne supprime pas les entrées PerformanceMark ; utilisez performance.clearMarks() pour cela.

Supprimez vos propres mesures après les avoir lues. Dans du code qui partage une page avec d’autres modules, préférez transmettre un nom plutôt que d’appeler la méthode sans argument, afin d’éviter de supprimer les mesures des autres modules. L’exemple crée deux mesures portant le même nom et vérifie leur nombre avant et après la suppression, sans afficher de valeurs de durée variables.

Il s’agit d’une API Web spécifiée par User Timing, et non d’une fonctionnalité du langage ECMAScript. La méthode figure déjà dans User Timing Level 2. Vérifiez sa disponibilité dans le navigateur cible, par exemple avec typeof performance.clearMeasures === "function" ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge dans les navigateurs.

Exemples

(() => {
  const name = "cktis.clearMeasures.demo";
  performance.clearMeasures(name);
  try {
    performance.measure(name);
    performance.measure(name);
    console.log(performance.getEntriesByName(name, "measure").length);
    const result = performance.clearMeasures(name);
    console.log(performance.getEntriesByName(name, "measure").length);
    console.log(result === undefined);
  } finally {
    performance.clearMeasures(name);
  }
})();

Résultat

2
0
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.

Sources