CKTIS / JavaScript
Performance.getEntriesByName — pobieranie wpisów według nazwy
Performance.getEntriesByName pobiera bieżące wpisy osi czasu wydajności o wskazanej nazwie i opcjonalnie typie. Zwraca tablicę, a nie pojedynczy wpis, i nie śledzi przyszłych zdarzeń.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
performance.getEntriesByName(name)
performance.getEntriesByName(name, type)Performance.getEntriesByName to metoda Web API wywoływana jako performance.getEntriesByName(name, type). Wymagany name określa nazwę wpisu; opcjonalny type, np. "mark", zawęża wynik. Bez niego filtrowanie odbywa się tylko według nazwy. Nie jest to funkcja samego ECMAScript.
Wynikiem jest tablica obiektów PerformanceEntry uporządkowana rosnąco według startTime. Kilka wpisów może mieć tę samą nazwę; brak dopasowań daje []. Metoda odczytuje wpisy obecne w chwili wywołania, nie subskrybuje kolejnych. Do powiadomień służy PerformanceObserver.
Nie wszystkie typy są dostępne tą metodą: między innymi "element", "event", "largest-contentful-paint", "layout-shift" i "longtask" wymagają PerformanceObserver. MDN oznacza metodę jako szeroko dostępną w przeglądarkach od września 2017 r.; jest też dostępna w Web Workers. Obecność Node 24 w repozytorium nie dowodzi obsługi w przeglądarce.
Przykład tworzy dwa znaczniki o tej samej nazwie i pobiera je z filtrem "mark". Celowo nie wypisuje zmiennych znaczników czasu. Usuwa znaczniki o nazwie demonstracyjnej przed uruchomieniem i w finally, nie naruszając pozostałych nazw.
Przykłady
(() => {
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);
}
})();Wynik
2 mark,mark true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.