Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

performance.clearMeasures() — rimuovere le misurazioni User Timing

performance.clearMeasures() rimuove le misurazioni User Timing salvate dal buffer delle voci di performance. Puoi rimuovere tutte le misurazioni o tutte le voci con un determinato nome, senza eliminare i marcatori temporali.

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.clearMeasures();
performance.clearMeasures(measureName);

performance.clearMeasures() rimuove dal buffer delle voci di performance gli oggetti PerformanceMeasure creati da performance.measure(). Senza argomenti, rimuove tutte le misurazioni; performance.clearMeasures(measureName) rimuove tutte quelle con quel nome esatto, non soltanto l’ultima.

L’argomento facoltativo measureName è un nome di tipo DOMString. Se non ci sono misurazioni corrispondenti, la chiamata non rimuove nulla. Il valore restituito è sempre undefined, non il numero di voci eliminate. Il metodo non rimuove le voci PerformanceMark; per quelle usa performance.clearMarks().

Rimuovi le tue misurazioni dopo averle lette. Nel codice che condivide una pagina con altri moduli, preferisci passare un nome invece di chiamare il metodo senza argomenti, per evitare di eliminare le misurazioni degli altri moduli. L’esempio crea due misurazioni con lo stesso nome e ne controlla il numero prima e dopo la rimozione, senza stampare valori temporali variabili.

Questa è una Web API specificata da User Timing, non una funzionalità del linguaggio ECMAScript. Il metodo è già presente in User Timing Level 2. Verifica la disponibilità nel browser di destinazione, ad esempio con typeof performance.clearMeasures === "function"; la presenza di Node 24 in un repository non dimostra il supporto nei browser.

Esempi

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

Risultato

2
0
true

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.

Fonti