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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.