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.