Spec-Zone.ru › Web APIs

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

Базовая Широко поддерживается

Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с сентября 2015 года.

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Примечание: Эта функция доступна в рабочих потоках.

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

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

Примечание: Этот метод не уведомляет вас о новых записях производительности; вы получите только те записи, которые присутствуют во временной шкале производительности на момент вызова этого метода. Для получения уведомлений о записях по мере их появления используйте PerformanceObserver.

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

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

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

Синтаксис

getEntriesByType(type)

Параметры

type

Тип записи для извлечения, например, "mark". Действительные типы записей перечислены в PerformanceEntry.entryType. Поддерживаемые entryTypes можно получить с помощью статического свойства PerformanceObserver.supportedEntryTypes.

Возвращаемое значение

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

Примеры

Вывод записей ресурсов

Следующий пример выводит все записи с типом "resource".

const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
  console.log(`${entry.name}'s startTime: ${entry.startTime}`);
});

Спецификации

Спецификация
Временная шкала производительности
# dom-performance-getentriesbytype

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
getEntriesByType 2825–36 12 35 1515–23 11 2825–36 35 1514–24 11 1.51.5–3.0 4.4

См. также

  • Performance.getEntries()
  • Performance.getEntriesByName()
  • PerformanceObserver.supportedEntryTypes

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Performance/getEntriesByType

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API