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

CKTIS / JavaScript

performance.measure — intervalos de tiempo con nombre

performance.measure registra un intervalo con nombre en la línea de tiempo de rendimiento. Puede usar marcas o marcas de tiempo explícitas; la sobrecarga moderna devuelve un PerformanceMeasure con el inicio y la duración del intervalo en milisegundos.

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.measure(name)
performance.measure(name, startMark, endMark)
performance.measure(name, { start, end, detail })
performance.measure(name, { start, duration, detail })
performance.measure(name, { end, duration, detail })

performance.measure pertenece a la API web User Timing, no a ECMAScript. Registra una entrada de tipo "measure"; la sobrecarga moderna devuelve un PerformanceMeasure con name, startTime, duration y detail. No ejecuta ni mide automáticamente una función que se le pase.

performance.measure(name) abarca el intervalo desde cero en la línea de tiempo de rendimiento hasta la llamada. La sobrecarga con nombres de marca utiliza la última performance.mark coincidente. El objeto de opciones acepta start y end como nombres de marca o marcas de tiempo en milisegundos relativas al origen temporal de rendimiento, no a la época Unix. Se puede proporcionar start con duration o end con duration, pero no los tres campos a la vez.

Se permite un objeto de opciones vacío. Si no está vacío, debe incluir start o end y no admite un tercer argumento; infringir estas reglas produce un TypeError. Si falta una marca con nombre normal, se produce un SyntaxError. Una marca de tiempo de entrada negativa produce un TypeError, pero la duration resultante puede ser negativa. detail se copia mediante clonación estructurada.

El ejemplo usa marcas de tiempo artificiales: muestra cómo calcular un intervalo, no es una prueba de velocidad. performance.clearMeasures(name) elimina las mediciones guardadas con ese nombre, pero no las marcas. El objeto de opciones y la entrada devuelta proceden de extensiones del nivel 3; el nivel 2 devolvía undefined. Ni la mera presencia del método ni Node 24 demuestran que esta sobrecarga sea compatible con un navegador determinado.

Ejemplos

(() => {
  const name = "cktis:measure-demo";
  try {
    const entry = performance.measure(name, { start: 10, end: 35 });
    console.log(`${entry.entryType}: ${entry.startTime} + ${entry.duration} ms`);
  } finally {
    performance.clearMeasures(name);
  }
})();

Resultado

measure: 10 + 25 ms

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