База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Performance.getEntriesByName — извличане на записи по име

Performance.getEntriesByName извлича текущите записи от времевата линия на производителността с посочено име и по избор тип. Връща масив, а не един запис, и не следи бъдещи събития.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

performance.getEntriesByName(name)
performance.getEntriesByName(name, type)

Performance.getEntriesByName е метод от Web API, който се извиква като performance.getEntriesByName(name, type). Задължителният параметър name задава името на записа; незадължителният параметър type, например "mark", стеснява резултата. Ако го пропуснете, филтрирането е само по име. Това не е функционалност на самия ECMAScript.

Резултатът е масив от обекти PerformanceEntry, сортирани във възходящ ред по startTime. Няколко записа могат да имат едно и също име; ако няма съвпадения, резултатът е []. Методът чете записите, налични в момента на извикването, вместо да се абонира за следващи записи. За известия използвайте PerformanceObserver.

Не до всички типове записи може да се достигне чрез този метод: типове като "element", "event", "largest-contentful-paint", "layout-shift" и "longtask" изискват PerformanceObserver. MDN посочва, че методът е широко достъпен в браузърите от септември 2017 г.; наличен е и в Web Workers. Наличието на Node 24 в хранилище не доказва поддръжка в браузърите.

Примерът създава две маркери с едно и също име и ги извлича с филтъра "mark". Умишлено не извежда променливи времеви отметки. Изчиства маркерите с демонстрационното име преди изпълнение и във finally, без да засяга маркерите с други имена.

Примери

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

Резултат

2
mark,mark
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници