PerformanceScriptTiming

Интерфейс PerformanceScriptTiming описан в API длинных кадров анимации и предоставляет метрики по отдельным скриптам, которые вносят вклад в длинные кадры анимации (LoAF).

Длинные кадры анимации (LoAF) — это обновления рендеринга, задержка которых превышает 50 мс. LoAF могут привести к медленным обновлениям пользовательского интерфейса (UI), в результате чего элементы управления могут казаться неотзывчивыми и появляться не плавные (негладкие) анимационные эффекты и прокрутка. Это часто приводит к раздражению пользователя.

Интерфейс PerformanceScriptTiming (экземпляры которого доступны через свойство PerformanceLongAnimationFrameTiming.scripts) предоставляет следующий набор подробной информации об отдельных скриптах, которые вносят вклад в LoAF, что позволяет разработчикам сузить область поиска причин:

• Подробный набор временных меток для каждого скрипта.
• Идентификатор и тип вызывающего элемента, т. е. функциональности, которая, при вызове, выполнила скрипт.
• Подробная информация о каждом исходном файле скрипта, включая URL, имя функции и позицию символа, которые внесли вклад в LoAF.

PerformanceScriptTiming наследуется от PerformanceEntry.

Этот интерфейс расширяет следующие свойства PerformanceEntry для записей производительности длинных кадров анимации:

PerformanceEntry.duration Только для чтения Экспериментальная

Возвращает DOMHighResTimeStamp, представляющий время, прошедшее в миллисекундах между началом и окончанием выполнения скрипта.

PerformanceEntry.entryType Только для чтения Экспериментальная

Возвращает тип записи, который всегда "script".

PerformanceEntry.name Только для чтения Экспериментальная

Возвращает имя записи, которое всегда "script".

PerformanceEntry.startTime Только для чтения Экспериментальная

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

Этот интерфейс также поддерживает следующие свойства:

PerformanceScriptTiming.executionStart Только для чтения Экспериментальная

Возвращает DOMHighResTimeStamp, указывающий время завершения компиляции скрипта и начала выполнения.

PerformanceScriptTiming.forcedStyleAndLayoutDuration Только для чтения Экспериментальная

Возвращает DOMHighResTimeStamp, указывающий общее время, потраченное скриптом в миллисекундах на принудительное форматирование/разметку. Обратитесь к Избегание перерасчета разметки, чтобы понять, что вызывает это.

PerformanceScriptTiming.invoker Только для чтения Экспериментальная

Возвращает строковое значение, указывающее идентификатор функциональности, которая, при вызове, выполнила скрипт.

PerformanceScriptTiming.invokerType Только для чтения Экспериментальная

Возвращает строковое значение, указывающее тип функциональности, которая, при вызове, выполнила скрипт.

PerformanceScriptTiming.pauseDuration Только для чтения Экспериментальная

Возвращает DOMHighResTimeStamp, указывающий общее время, потраченное скриптом в миллисекундах на «приостановку» синхронных операций (например, вызовы Window.alert() или синхронные XMLHttpRequest).

PerformanceScriptTiming.sourceCharPosition Только для чтения Экспериментальная

Возвращает число, представляющее позицию символа в скрипте функциональности, которая внесла вклад в LoAF.

PerformanceScriptTiming.sourceFunctionName Только для чтения Экспериментальная

Возвращает строку, представляющую имя функции, которая внесла вклад в LoAF.

PerformanceScriptTiming.sourceURL Только для чтения Экспериментальная

Возвращает строку, представляющую URL скрипта.

PerformanceScriptTiming.window Только для чтения Экспериментальная

Возвращает ссылку на объект Window, представляющий контекст выполнения (то есть либо документ верхнего уровня, либо <iframe>), в котором был выполнен скрипт, вызвавший LoAF.

PerformanceScriptTiming.windowAttribution Только для чтения Экспериментальная

Возвращает перечисление, описывающее отношение контейнера (то есть либо документа верхнего уровня, либо <iframe>), в котором был выполнен вызвавший LoAF скрипт, относительно окна, выполняющего текущий документ.

PerformanceScriptTiming.toJSON() Экспериментальная

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

См. Длинные кадры анимации для примеров, связанных с API длинных кадров анимации.

• Временные метки длинной анимации кадра
• PerformanceLongAnimationFrameTiming