CKTIS / JavaScript
Performance.getEntriesByName — recuperare voci per nome
Performance.getEntriesByName recupera le voci attuali della sequenza temporale delle prestazioni con un nome specificato e, facoltativamente, un tipo. Restituisce un array anziché una singola voce e non tiene traccia degli eventi futuri.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
performance.getEntriesByName(name)
performance.getEntriesByName(name, type)Performance.getEntriesByName è un metodo della Web API che si chiama come performance.getEntriesByName(name, type). Il parametro obbligatorio name identifica il nome della voce; il parametro facoltativo type, ad esempio "mark", restringe il risultato. Se viene omesso, il filtro considera solo il nome. Non è una funzionalità di ECMAScript in sé.
Il risultato è un array di oggetti PerformanceEntry, ordinati in modo crescente in base a startTime. Più voci possono avere lo stesso nome; se non ci sono corrispondenze, il risultato è []. Il metodo legge le voci presenti al momento della chiamata, invece di sottoscrivere quelle successive. Per ricevere notifiche, usa PerformanceObserver.
Non tutti i tipi di voce sono accessibili tramite questo metodo: tipi come "element", "event", "largest-contentful-paint", "layout-shift" e "longtask" richiedono PerformanceObserver. MDN indica che il metodo è ampiamente disponibile nei browser da settembre 2017; è disponibile anche nei Web Workers. La presenza di Node 24 in un repository non dimostra il supporto nei browser.
L’esempio crea due mark con lo stesso nome e li recupera usando il filtro "mark". Evita intenzionalmente di stampare timestamp variabili. Cancella i mark con il nome dimostrativo prima dell’esecuzione e in finally, senza modificare quelli con altri nomi.
Esempi
(() => {
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);
}
})();Risultato
2 mark,mark true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.