PerformanceObserverEntryList: метод getEntriesByName()

Метод getEntriesByName() интерфейса PerformanceObserverEntryList возвращает список явно наблюдаемых объектов PerformanceEntry для заданного name и entryType. Элементы списка определяются набором типов типов записей, указанных в вызове метода observe(). Список доступен в функции обратного вызова наблюдателя (в качестве первого параметра в функции обратного вызова).

name

Строка, представляющая имя записи для извлечения.

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

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

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

Следующий пример демонстрирует разницу между методами getEntries(), getEntriesByName(), и getEntriesByType().

const observer = new PerformanceObserver((list, obs) => {
  // Log all entries
  let perfEntries = list.getEntries();
  perfEntries.forEach((entry) => {
    console.log(`${entry.name}'s duration: ${entry.duration}`);
  });

  // Log entries named "debugging" with type "measure"
  perfEntries = list.getEntriesByName("debugging", "measure");
  perfEntries.forEach((entry) => {
    console.log(`${entry.name}'s duration: ${entry.duration}`);
  });

  // Log entries with type "mark"
  perfEntries = list.getEntriesByType("mark");
  perfEntries.forEach((entry) => {
    console.log(`${entry.name}'s startTime: ${entry.startTime}`);
  });
});

// Subscribe to various performance event types
observer.observe({
  entryTypes: ["mark", "measure", "navigation", "resource"],
});