CKTIS / JavaScript
performance.clearMeasures() — eliminar medidas de User Timing
performance.clearMeasures() elimina las medidas de User Timing guardadas en el búfer de entradas de rendimiento. Puedes eliminar todas las medidas o todas las entradas con un nombre concreto, sin borrar las marcas de tiempo.
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.clearMeasures();
performance.clearMeasures(measureName);performance.clearMeasures() elimina del búfer de entradas de rendimiento los objetos PerformanceMeasure creados por performance.measure(). Sin argumentos, elimina todas las medidas; performance.clearMeasures(measureName) elimina todas las medidas que tengan exactamente ese nombre, no solo la más reciente.
El argumento opcional measureName es un nombre de tipo DOMString. Si no hay medidas que coincidan, la llamada no elimina nada. El valor devuelto siempre es undefined, no el número de entradas eliminadas. El método no elimina las entradas PerformanceMark; para ello, usa performance.clearMarks().
Elimina tus propias medidas después de leerlas. En código que comparte una página, es preferible pasar un nombre en vez de llamar al método sin argumentos, para evitar borrar las medidas de otros módulos. El ejemplo crea dos medidas con el mismo nombre y comprueba cuántas hay antes y después de eliminarlas, sin mostrar valores de tiempo variables.
Esta es una API web especificada por User Timing, no una característica del lenguaje ECMAScript. El método ya aparece en User Timing Level 2. Comprueba su disponibilidad en el navegador de destino, por ejemplo con typeof performance.clearMeasures === "function"; que Node 24 esté presente en un repositorio no demuestra que haya compatibilidad en el navegador.
Ejemplos
(() => {
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
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.