Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti