performance.clearMarks()

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 clearMarks() supprime les marqueurs nommés 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 « mark » seront supprimées du tampon d'entrée de performance.

Note: Cette fonctionnalité est disponible via les Web Workers.

Syntaxe

js
performance.clearMarks();
performance.clearMarks(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 entryType de « mark » seront supprimés.

Valeur de retour

Aucune.

Exemple

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

js
// Créé une petite aide pour montrer combien d'entrées PerformanceMark il y a.
function logMarkCount() {
  console.log(
    "J'ai trouvé autant d'entrées : " +
      performance.getEntriesByType("mark").length,
  );
}

// Crée une série de marqueurs.
performance.mark("squirrel");
performance.mark("squirrel");
performance.mark("monkey");
performance.mark("monkey");
performance.mark("dog");
performance.mark("dog");

logMarkCount(); // "J'ai trouvé autant d'entrées : 6"

// Supprime seulement les entrées "squirrel" de PerformanceMark.
performance.clearMarks("squirrel");
logMarkCount(); // "J'ai trouvé autant d'entrées : 4"

// Supprime toutes les entrées de PerformanceMark.
performance.clearMarks();
logMarkCount(); // "J'ai trouvé autant d'entrées : 0"

Spécifications

Specification
User Timing Level 3
# dom-performance-clearmarks

Compatibilité des navigateurs

BCD tables only load in the browser