Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes