CKTIS / JavaScript
Performance.getEntriesByName — obtener entradas por nombre
Performance.getEntriesByName obtiene las entradas actuales de la línea de tiempo de rendimiento que tienen un nombre determinado y, de forma opcional, un tipo concreto. Devuelve un array, no una sola entrada, y no realiza un seguimiento de eventos futuros.
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.getEntriesByName(name)
performance.getEntriesByName(name, type)Performance.getEntriesByName es un método de la API Web que se invoca como performance.getEntriesByName(name, type). El parámetro obligatorio name indica el nombre de la entrada; el parámetro opcional type, por ejemplo "mark", restringe el resultado. Si se omite, solo se filtra por nombre. No es una función propia de ECMAScript.
El resultado es un array de objetos PerformanceEntry ordenados de forma ascendente según startTime. Puede haber varias entradas con el mismo nombre; si no hay coincidencias, se obtiene []. El método lee las entradas presentes en el momento de la llamada, en lugar de suscribirse a las que aparezcan después. Para recibir notificaciones, usa PerformanceObserver.
No se puede acceder a todos los tipos de entrada mediante este método: tipos como "element", "event", "largest-contentful-paint", "layout-shift" y "longtask" requieren PerformanceObserver. MDN indica que el método está ampliamente disponible en los navegadores desde septiembre de 2017; también está disponible en Web Workers. Que un repositorio incluya Node 24 no demuestra que haya compatibilidad con los navegadores.
El ejemplo crea dos marcas con el mismo nombre y las obtiene mediante el filtro "mark". Evita deliberadamente mostrar marcas de tiempo variables. Borra las marcas con el nombre de demostración antes de ejecutarse y en finally, sin afectar a las que tengan otros nombres.
Ejemplos
(() => {
const name = "cktis-getEntriesByName-demo";
performance.clearMarks(name);
try {
performance.mark(name);
performance.mark(name);
const entries = performance.getEntriesByName(name, "mark");
console.log(entries.length);
console.log(entries.map(entry => entry.entryType).join(","));
console.log(entries.every(entry => entry.name === name));
} finally {
performance.clearMarks(name);
}
})();Resultado
2 mark,mark 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.