Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Performance.getEntriesByName — pridobivanje vnosov po imenu

Performance.getEntriesByName pridobi trenutne vnose časovnice zmogljivosti z določenim imenom in neobvezno vrsto. Vrne polje namesto enega samega vnosa in ne spremlja prihodnjih dogodkov.

Različica: 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 je metoda Web API, ki se pokliče kot performance.getEntriesByName(name, type). Obvezni parameter name določa ime vnosa; neobvezni parameter type, na primer "mark", omeji rezultat. Če ga izpustite, se filtrira samo po imenu. To ni funkcija samega ECMAScripta.

Rezultat je polje objektov PerformanceEntry, razvrščenih naraščajoče po startTime. Več vnosov ima lahko isto ime; če ni zadetkov, je rezultat []. Metoda prebere vnose, ki so na voljo ob klicu, namesto da bi se naročila na poznejše vnose. Za obvestila uporabite PerformanceObserver.

Do vseh vrst vnosov ni mogoče dostopati s to metodo: vrste, kot so "element", "event", "largest-contentful-paint", "layout-shift" in "longtask", zahtevajo PerformanceObserver. MDN navaja, da je metoda od septembra 2017 široko podprta v brskalnikih; na voljo je tudi v Web Workers. Prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalnikih.

Primer ustvari dve oznaki z istim imenom in ju pridobi s filtrom "mark". Namenoma ne izpiše spremenljivih časovnih žigov. Oznake z demonstracijskim imenom izbriše pred izvajanjem in v finally, drugih imen pa se ne dotakne.

Primeri

(() => {
  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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri