Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje