PerformanceEntry

Объект PerformanceEntry инкапсулирует один показатель производительности, который является частью временной шкалы производительности браузера.

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

Запись производительности также можно создать, вызвав методы Performance.mark() или Performance.measure() в явном месте приложения. Это позволяет добавить собственные метрики в временную шкалу производительности.

Экземпляры PerformanceEntry всегда будут одним из следующих подклассов:

• LargestContentfulPaint
• LayoutShift
• PerformanceEventTiming
• PerformanceLongAnimationFrameTiming
• PerformanceLongTaskTiming
• PerformanceMark
• PerformanceMeasure
• PerformanceNavigationTiming
• PerformancePaintTiming
• PerformanceResourceTiming
• PerformanceScriptTiming
• PerformanceServerTiming
• TaskAttributionTiming
• VisibilityStateEntry

PerformanceEntry.name Только для чтения

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

PerformanceEntry.entryType Только для чтения

Строка, представляющая тип показателя производительности. Например, "mark" при использовании PerformanceMark.

PerformanceEntry.startTime Только для чтения

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

PerformanceEntry.duration Только для чтения

DOMHighResTimeStamp, представляющий длительность записи производительности.

PerformanceEntry.toJSON()

Возвращает JSON-представление объекта PerformanceEntry.

Следующий пример создаёт объекты PerformanceEntry, которые являются типами PerformanceMark и PerformanceMeasure. Подклассы PerformanceMark и PerformanceMeasure наследуют свойства duration, entryType, name, и startTime от PerformanceEntry и устанавливают их соответствующие значения.

// Place at a location in the code that starts login
performance.mark("login-started");

// Place at a location in the code that finishes login
performance.mark("login-finished");

// Measure login duration
performance.measure("login-duration", "login-started", "login-finished");

function perfObserver(list, observer) {
  list.getEntries().forEach((entry) => {
    if (entry.entryType === "mark") {
      console.log(`${entry.name}'s startTime: ${entry.startTime}`);
    }
    if (entry.entryType === "measure") {
      console.log(`${entry.name}'s duration: ${entry.duration}`);
    }
  });
}
const observer = new PerformanceObserver(perfObserver);
observer.observe({ entryTypes: ["measure", "mark"] });