CKTIS / JavaScript
Performance.getEntriesByName — načtení záznamů podle názvu
Performance.getEntriesByName načítá aktuální záznamy z časové osy výkonu se zadaným názvem a případně typem. Vrací pole, nikoli jeden záznam, a nesleduje budoucí události.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
performance.getEntriesByName(name)
performance.getEntriesByName(name, type)Performance.getEntriesByName je metoda Web API, která se volá jako performance.getEntriesByName(name, type). Povinný parametr name určuje název záznamu; nepovinný parametr type, například "mark", výsledek zúží. Pokud ho vynecháte, filtruje se pouze podle názvu. Nejde o funkci samotného ECMAScriptu.
Výsledkem je pole objektů PerformanceEntry seřazených vzestupně podle startTime. Více záznamů může mít stejný název; pokud se nenajdou žádné shody, výsledkem je []. Metoda čte záznamy přítomné v okamžiku volání, místo aby se přihlásila k odběru dalších záznamů. Pro upozornění použijte PerformanceObserver.
Ne ke všem typům záznamů lze touto metodou přistupovat: typy jako "element", "event", "largest-contentful-paint", "layout-shift" a "longtask" vyžadují PerformanceObserver. MDN uvádí, že metoda je od září 2017 široce dostupná v prohlížečích; dostupná je také ve Web Workers. Přítomnost Node 24 v repozitáři nedokládá podporu v prohlížečích.
Příklad vytvoří dvě značky se stejným názvem a načte je pomocí filtru "mark". Záměrně nevypisuje proměnlivé časové značky. Značky s demonstračním názvem odstraní před spuštěním a ve finally, ostatní názvy ponechá beze změny.
Příklady
(() => {
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);
}
})();Výsledek
2 mark,mark true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.