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

js
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().

js
// 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

Specification
User Timing
# dom-performance-clearmeasures

Compatibilité des navigateurs

BCD tables only load in the browser