performance.clearMeasures()

La méthode clearMeasures() supprime les mesures nommées du tampon d'entrée des performances du navigateur. Si la méthode est appelée sans arguments, toutes les entrées de performance avec un entryType de « measure » seront supprimées du tampon d'entrée de performance.

Note: Cette fonctionnalité est disponible via les Web Workers

Syntaxe

  performance.clearMeasures();
  performance.clearMeasures(name);

Arguments

name Facultatif
Un DOMString représentant le nom de l'horodatage. Si cet argument est omis, toutes les entrées de performance avec un entrType de « measure » seront supprimés.

Valeur de retour

Aucune.

Exemple

L'exemple suivant montre les deux utilisations de la méthode clearMeasures().

// Crée une petite aide pour montrer combien d'entrées PerformanceMeasure il y a.
function logMeasureCount() {
  console.log(
    "J'ai trouvé ces nombreuses entrées : " + performance.getEntriesByType("measure").length
  );
}

// Crée un ensemble de mesures.
performance.measure("from navigation");
performance.mark("a");
performance.measure("from mark a", "a");
performance.measure("from navigation");
performance.measure("from mark a", "a");
performance.mark("b");
performance.measure("between a and b", "a", "b");

logMeasureCount() // "J'ai trouvé ces nombreuses entrées : 5"

// Supprime uniquement les entrées PerformanceMeasure "from navigation".
performance.clearMeasures("from navigation");
logMeasureCount() // "J'ai trouvé ces nombreuses entrées : 3"

// Supprime toutes les entrées de PerformanceMeasure.
performance.clearMeasures();
logMeasureCount() // "J'ai trouvé ces nombreuses entrées : 0"

Spécifications

Spécification Statut Commentaire
User Timing Level 2
La définition de 'clearMeasures()' dans cette spécification.
Version de travail Carification de clearMeasures().
User Timing
La définition de 'clearMeasures()' dans cette spécification.
Recommendation Définition initiale.

Compatibilité des navigateurs

BCD tables only load in the browser