Spec-Zone.ru › Web APIs

PerformanceEntry: свойство entryType

Базовая Широко доступная

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

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

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

Только для чтения entryType свойство возвращает строку, представляющую тип метрики производительности, который представляет эта запись.

Все поддерживаемые entryTypes доступны с помощью статического свойства PerformanceObserver.supportedEntryTypes.

Значение

Строка. Возвращаемое значение зависит от подтипа объекта PerformanceEntry. Некоторые подтипы имеют более одного entryType.

element

Отчет о времени загрузки элементов.

Объект записи будет объектом PerformanceElementTiming.

event

Отчет о задержках событий.

Объект записи будет объектом PerformanceEventTiming.

first-input

Отчет о задержке первого ввода (FID).

Объект записи будет объектом PerformanceEventTiming объекта.

largest-contentful-paint

Отчет о самом большом обновлении, которое элемент инициировал на экране.

Объект записи будет объектом LargestContentfulPaint.

layout-shift

Отчет о стабильности макета веб-страниц на основе перемещений элементов на странице.

Объект записи будет объектом LayoutShift.

long-animation-frame

Отчет о случаях длинных кадров анимации (LoAF).

Объект записи будет объектом PerformanceLongAnimationFrameTiming.

longtask

Отчет о случаях выполнения длинных задач.

Объект записи будет объектом PerformanceLongTaskTiming.

mark

Отчет о ваших собственных пользовательских маркерах производительности.

Объект записи будет объектом PerformanceMark.

measure

Отчет о ваших собственных пользовательских измерениях производительности.

Объект записи будет объектом PerformanceMeasure.

navigation

Отчет о времени навигации документа.

Объект записи будет объектом PerformanceNavigationTiming.

paint

Отчет о ключевых моментах рендеринга документа (первое изображение, первое содержательное изображение) во время загрузки страницы.

Объект записи будет объектом PerformancePaintTiming.

resource

Отчет о временной информации для ресурсов в документе.

Объект записи будет объектом PerformanceResourceTiming.

taskattribution

Отчет о типе работы, который значительно повлиял на выполнение длительной задачи.

Объект записи будет объектом TaskAttributionTiming.

visibility-state

Отчет о времени изменения состояния видимости страницы, т. е. когда вкладка переключается с фоновой на фоновую или наоборот.

Объект записи будет объектом VisibilityStateEntry.

Примеры

Фильтрация записей производительности по типу

Свойство entryType может быть полезным при фильтрации определенных записей производительности. Например, вы можете проверить все скриптовые ресурсы, поэтому вам нужно проверить entryType типа "resource" и initiatorType типа "script".

const scriptResources = performance
  .getEntries()
  .filter(
    (entry) =>
      entry.entryType === "resource" && entry.initiatorType === "script",
  );
console.log(scriptResources);

Получение записей производительности по типу

Как Performance, так и PerformanceObserver предоставляют методы, которые позволяют получить записи производительности по типу напрямую. Вам не обязательно нужно свойство entryType для этого, вместо этого вы можете использовать Performance.getEntriesByType() или PerformanceObserverEntryList.getEntriesByType().

Кроме того, при наблюдении с помощью PerformanceObserver метод observe() принимает массив entryTypes в своем объекте опций, где вы можете выбрать типы записей, которые нужно наблюдать.

// Log all resource entries at this point
const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
  console.log(`${entry.name}'s duration: ${entry.duration}`);
});

// PerformanceObserver version
// Log all resource entries when they are available
function perfObserver(list, observer) {
  list.getEntriesByType("resource").forEach((entry) => {
    console.log(`${entry.name}'s duration: ${entry.duration}`);
  });
}
const observer = new PerformanceObserver(perfObserver);
observer.observe({ entryTypes: ["resource", "navigation"] });

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

Спецификация
Performance Timeline
# dom-performanceentry-entrytype

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

Рабочий стол Мобильный
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari на iOS Samsung Internet WebView Android
entryType 28 12 35 15 11 28 35 14 11 1.5 4.4

См. также

  • PerformanceObserver.supportedEntryTypes
  • Performance.getEntriesByType()
  • PerformanceObserverEntryList.getEntriesByType()

© 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/PerformanceEntry/entryType

Spec-Zone.ru

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