CKTIS / JavaScript
Performance.getEntriesByName — načítanie záznamov podľa názvu
Performance.getEntriesByName načíta aktuálne záznamy z časovej osi výkonu so zadaným názvom a prípadne typom. Vráti pole, nie jeden záznam, a nesleduje budúce udalosti.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
performance.getEntriesByName(name)
performance.getEntriesByName(name, type)Performance.getEntriesByName je metóda Web API, ktorá sa volá ako performance.getEntriesByName(name, type). Povinný parameter name určuje názov záznamu; nepovinný parameter type, napríklad "mark", zúži výsledok. Ak ho vynecháte, filtruje sa iba podľa názvu. Nie je to funkcia samotného ECMAScriptu.
Výsledkom je pole objektov PerformanceEntry zoradených vzostupne podľa startTime. Viaceré záznamy môžu mať rovnaký názov; ak sa nenájdu žiadne zhody, výsledkom je []. Metóda číta záznamy prítomné v čase volania, namiesto toho, aby sa prihlásila na odber ďalších záznamov. Na upozornenia použite PerformanceObserver.
Nie ku všetkým typom záznamov možno pristupovať touto metódou: typy ako "element", "event", "largest-contentful-paint", "layout-shift" a "longtask" vyžadujú PerformanceObserver. MDN uvádza, že metóda je od septembra 2017 široko dostupná v prehliadačoch; dostupná je aj vo Web Workers. Prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadačoch.
Príklad vytvorí dve značky s rovnakým názvom a načíta ich pomocou filtra "mark". Zámerne nevypisuje premenlivé časové značky. Značky s názvom ukážky odstráni pred spustením a vo finally, ostatné názvy ponechá nedotknuté.
Prí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ýsledok
2 mark,mark true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.