Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

performance.clearMarks() — supprimer des marqueurs de temps

performance.clearMarks() supprime les marqueurs User Timing du tampon des entrées de performance. Avec un nom, tous les marqueurs correspondants sont supprimés ; sans argument, tous les marqueurs sont supprimés, mais pas les mesures.

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.clearMarks();
performance.clearMarks(markName);

performance.clearMarks(markName) supprime du tampon des entrées de performance tous les objets PerformanceMark portant exactement le nom indiqué, et pas seulement le plus récent. Si aucun marqueur ne correspond, rien ne change. La méthode renvoie undefined, et non le nombre d’entrées supprimées.

performance.clearMarks() sans argument supprime tous les marqueurs. Cette méthode ne supprime pas les entrées PerformanceMeasure ; utilisez performance.clearMeasures() pour cela. Privilégiez la suppression par nom afin de ne pas effacer les marqueurs appartenant à d’autres composants de l’application.

Créez une mesure avant de supprimer les marqueurs auxquels elle fait référence par leur nom. Un appel ultérieur à performance.measure() utilisant le nom d’un marqueur applicatif supprimé déclenche SyntaxError, à moins que ce marqueur ne soit recréé. Les mesures existantes restent dans le tampon.

Il s’agit d’une API Web spécifiée par User Timing, et non d’une fonctionnalité d’une édition particulière d’ECMAScript ; elle figure déjà dans User Timing Level 2. La spécification n’est pas un tableau de compatibilité des navigateurs. Vérifiez typeof globalThis.performance?.clearMarks === "function" dans l’environnement cible ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs.

Exemples

(() => {
  const name = "cktis:clearMarks:demo";
  performance.clearMarks(name);
  try {
    performance.mark(name);
    performance.mark(name);
    console.log(performance.getEntriesByName(name, "mark").length);
    const result = performance.clearMarks(name);
    console.log(performance.getEntriesByName(name, "mark").length);
    console.log(result === undefined);
    performance.clearMarks(name);
    console.log(performance.getEntriesByName(name, "mark").length);
  } finally {
    performance.clearMarks(name);
  }
})();

Résultat

2
0
true
0

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.

Sources