Производительность: метод getEntriesByName()

Метод getEntriesByName() возвращает массив объектов PerformanceEntry, которые в данный момент присутствуют в временной шкале производительности с заданным именем и типом.

Если вас интересуют записи производительности определенных типов, см. getEntriesByType(). Для всех записей производительности см. getEntries().

Следующие типы записей вообще не поддерживаются этим методом и не будут возвращены, даже если записи этих типов могут существовать:

• "element" (PerformanceElementTiming)
• "event" (PerformanceEventTiming)
• "largest-contentful-paint" (LargestContentfulPaint)
• "layout-shift" (LayoutShift)
• "longtask" (PerformanceLongTaskTiming)

Для доступа к записям этих типов необходимо использовать PerformanceObserver вместо этого.

name

Имя записей для получения.

type Необязательно

Тип записей для получения, например, "mark". Допустимые типы записей перечислены в PerformanceEntry.entryType.

Массив Array объектов PerformanceEntry, у которых указаны name и type. Элементы будут отсортированы в хронологическом порядке на основе startTime записей. Если объекты, соответствующие указанным критериям, отсутствуют, возвращается пустой массив.

В следующем примере выводятся все объекты PerformanceMark с именем "debug-mark".

const debugMarks = performance.getEntriesByName("debug-mark", "mark");
debugMarks.forEach((entry) => {
  console.log(`${entry.name}'s startTime: ${entry.startTime}`);
});

• Performance.getEntries()
• Performance.getEntriesByType()