CKTIS / JavaScript
performance.clearMarks() — rimuovere i marcatori temporali
performance.clearMarks() rimuove i marcatori User Timing dal buffer delle voci di performance. Se si specifica un nome, rimuove tutti i marcatori corrispondenti; senza argomenti rimuove tutti i marcatori, ma non le misurazioni.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
performance.clearMarks();
performance.clearMarks(markName);performance.clearMarks(markName) rimuove dal buffer delle voci di performance tutti gli oggetti PerformanceMark con esattamente il nome specificato, non solo quello più recente. Se non ci sono marcatori corrispondenti, non cambia nulla. Il metodo restituisce undefined, non il numero di voci rimosse.
performance.clearMarks() senza argomenti rimuove tutti i marcatori. Non rimuove le voci PerformanceMeasure; per quelle usa performance.clearMeasures(). Preferisci la rimozione per nome per evitare di cancellare marcatori appartenenti ad altri componenti dell’applicazione.
Crea una misurazione prima di rimuovere i marcatori a cui fa riferimento tramite nome. Una successiva chiamata a performance.measure() che usa il nome di un marcatore dell’applicazione eliminato genera SyntaxError, a meno che il marcatore non venga creato di nuovo. Le misurazioni esistenti restano nel buffer.
Questa è una Web API specificata da User Timing, non una funzionalità di una particolare edizione di ECMAScript; è già presente in User Timing Level 2. La specifica non è una tabella di compatibilità dei browser. Controlla typeof globalThis.performance?.clearMarks === "function" nell’ambiente di destinazione; la presenza di Node 24 in un repository non dimostra il supporto nei browser.
Esempi
(() => {
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);
}
})();Risultato
2 0 true 0
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.