Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje