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.