CKTIS / JavaScript
Performance.getEntriesByName — dohvaćanje unosa prema nazivu
Performance.getEntriesByName dohvaća trenutačne unose s vremenske crte performansi koji imaju zadani naziv i, neobavezno, vrstu. Vraća polje umjesto jednog unosa i ne prati buduće događaje.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
performance.getEntriesByName(name)
performance.getEntriesByName(name, type)Performance.getEntriesByName metoda je Web API-ja koja se poziva kao performance.getEntriesByName(name, type). Obavezni parametar name određuje naziv unosa; neobavezni parametar type, primjerice "mark", sužava rezultat. Ako ga izostavite, filtrira se samo prema nazivu. To nije značajka samog ECMAScripta.
Rezultat je polje objekata PerformanceEntry sortiranih uzlazno prema startTime. Više unosa može imati isti naziv; ako nema podudaranja, rezultat je []. Metoda čita unose prisutne u trenutku poziva, umjesto da se pretplati na kasnije unose. Za obavijesti upotrijebite PerformanceObserver.
Nije svim vrstama unosa moguće pristupiti ovom metodom: vrste kao što su "element", "event", "largest-contentful-paint", "layout-shift" i "longtask" zahtijevaju PerformanceObserver. MDN navodi da je metoda široko dostupna u preglednicima od rujna 2017.; dostupna je i u Web Workers. To što se u repozitoriju nalazi Node 24 ne dokazuje podršku u preglednicima.
Primjer stvara dvije oznake istog naziva i dohvaća ih filtrom "mark". Namjerno ne ispisuje promjenjive vremenske oznake. Oznake s demonstracijskim nazivom briše prije izvođenja i u finally, a ostale nazive ne dira.
Primjeri
(() => {
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);
}
})();Rezultat
2 mark,mark true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.