The getEntriesByName()
method returns an array of PerformanceEntry
objects currently present in the performance timeline with the given name and type.
If you are interested in performance entries of certain types, see getEntriesByType()
. For all performance entries, see getEntries()
.
Note: This method does not notify you about new performance entries; you will only get entries that are present in the performance timeline at the time you call this method. To receive notifications about entries as they become available, use a PerformanceObserver
.
The following entry types are not supported by this method at all and won't be returned even if entries for these types might exist:
-
"element"
(PerformanceElementTiming
) -
"event"
(PerformanceEventTiming
) -
"largest-contentful-paint"
(LargestContentfulPaint
) -
"layout-shift"
(LayoutShift
) -
"longtask"
(PerformanceLongTaskTiming
)
To access entries of these types, you must use a PerformanceObserver
instead.