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

CKTIS / JavaScript

performance.clearMarks() — remover marcas temporais

performance.clearMarks() remove marcas User Timing do buffer de entradas de desempenho. Se indicar um nome, remove todas as marcas correspondentes; sem argumentos, remove todas as marcas, mas não as medições.

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

performance.clearMarks(markName) remove do buffer de entradas de desempenho todos os objetos PerformanceMark com exatamente o nome indicado, e não apenas o mais recente. Se não houver nenhuma marca correspondente, nada muda. O método devolve undefined, não o número de entradas removidas.

performance.clearMarks() sem argumentos remove todas as marcas. Não remove entradas PerformanceMeasure; para isso, utilize performance.clearMeasures(). Prefira remover por nome para evitar apagar marcas pertencentes a outros componentes da aplicação.

Crie uma medição antes de remover as marcas a que se refere pelo nome. Uma chamada posterior a performance.measure() que utilize o nome de uma marca da aplicação já removida lança SyntaxError, a menos que essa marca seja criada novamente. As medições existentes permanecem no buffer.

Esta é uma API Web especificada por User Timing, não uma funcionalidade de uma edição específica de ECMAScript; já consta de User Timing Level 2. A especificação não é uma tabela de compatibilidade dos navegadores. Verifique typeof globalThis.performance?.clearMarks === "function" no ambiente de destino; a presença de Node 24 num repositório não comprova o suporte nos navegadores.

Exemplos

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

Resultado

2
0
true
0

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