Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

performance.clearMeasures() — remover medições User Timing

performance.clearMeasures() remove as medições User Timing guardadas do buffer de entradas de desempenho. Pode remover todas as medições ou todas as entradas com um nome específico, sem eliminar as marcas temporais.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

performance.clearMeasures();
performance.clearMeasures(measureName);

performance.clearMeasures() remove do buffer de entradas de desempenho os objetos PerformanceMeasure criados por performance.measure(). Sem argumentos, remove todas as medições; performance.clearMeasures(measureName) remove todas as medições com esse nome exato, não apenas a mais recente.

O argumento opcional measureName é um nome do tipo DOMString. Se não houver medições correspondentes, a chamada não remove nada. O valor devolvido é sempre undefined, não o número de entradas eliminadas. O método não remove entradas PerformanceMark; para isso, utilize performance.clearMarks().

Remova as suas próprias medições depois de as consultar. Em código que partilha uma página com outros módulos, prefira indicar um nome em vez de chamar o método sem argumentos, para evitar eliminar as medições de outros módulos. O exemplo cria duas medições com o mesmo nome e verifica a respetiva quantidade antes e depois da remoção, sem apresentar valores de tempo variáveis.

Esta é uma Web API especificada por User Timing, não uma funcionalidade da linguagem ECMAScript. O método já consta de User Timing Level 2. Verifique a disponibilidade no navegador de destino, por exemplo com typeof performance.clearMeasures === "function"; a presença de Node 24 num repositório não comprova o suporte nos navegadores.

Exemplos

(() => {
  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);
  }
})();

Resultado

2
0
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes