performance.clearMeasures()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

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 Level 3
# dom-performance-clearmeasures

Compatibilité des navigateurs

BCD tables only load in the browser