CKTIS / JavaScript
performance.clearMarks() — eliminar marcas de tiempo
performance.clearMarks() elimina las marcas de User Timing del búfer de entradas de rendimiento. Si se proporciona un nombre, elimina todas las marcas coincidentes; sin argumentos, elimina todas las marcas, pero no las mediciones.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
performance.clearMarks();
performance.clearMarks(markName);performance.clearMarks(markName) elimina del búfer de entradas de rendimiento todos los objetos PerformanceMark cuyo nombre coincide exactamente con el indicado, no solo el más reciente. Si no hay ninguna marca coincidente, no cambia nada. El método devuelve undefined, no el número de entradas eliminadas.
performance.clearMarks() sin argumentos elimina todas las marcas. No elimina las entradas PerformanceMeasure; para ello, usa performance.clearMeasures(). Es preferible borrar por nombre para evitar eliminar marcas que pertenecen a otros componentes de la aplicación.
Crea una medición antes de borrar las marcas a las que hace referencia por nombre. Una llamada posterior a performance.measure() que use el nombre de una marca de la aplicación ya eliminada lanza SyntaxError, a menos que se vuelva a crear esa marca. Las mediciones existentes permanecen en el búfer.
Esta es una API web especificada por User Timing, no una característica de una edición concreta de ECMAScript; ya aparece en User Timing Level 2. La especificación no es una tabla de compatibilidad de navegadores. Comprueba typeof globalThis.performance?.clearMarks === "function" en el entorno de destino; que Node 24 esté en un repositorio no demuestra que los navegadores lo admitan.
Ejemplos
(() => {
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.