PerformanceLongAnimationFrameTiming

Instanzeigenschaften

Dieses Interface definiert direkt die folgenden Eigenschaften:

PerformanceLongAnimationFrameTiming.blockingDuration Schreibgeschützt

Gibt einen DOMHighResTimeStamp zurück, der die Gesamtzeit in Millisekunden angibt, während der der Hauptthread daran gehindert war, auf Aufgaben mit hoher Priorität wie Benutzereingaben zu reagieren. Zur Berechnung werden alle langen Aufgaben innerhalb des LoAF mit einer duration von mehr als 50ms berücksichtigt. Von jeder wird 50ms abgezogen, die Rendering-Zeit wird zur Dauer der längsten Aufgabe addiert und die Ergebnisse werden aufsummiert.

PerformanceLongAnimationFrameTiming.firstUIEventTimestamp Schreibgeschützt

Gibt einen DOMHighResTimeStamp zurück, der den Zeitpunkt des ersten UI-Ereignisses angibt – etwa eines Maus- oder Tastaturereignisses –, das während des aktuellen Animationsframes in die Warteschlange eingereiht wurde.

PerformanceLongAnimationFrameTiming.paintTime Schreibgeschützt

Gibt den Zeitstempel zurück, zu dem die Rendering-Phase endete und der Animationsframe begann.

PerformanceLongAnimationFrameTiming.presentationTime Schreibgeschützt

Gibt den Zeitstempel zurück, zu dem die aktualisierte Benutzeroberfläche tatsächlich auf dem Bildschirm dargestellt wurde.

PerformanceLongAnimationFrameTiming.renderStart Schreibgeschützt

Gibt einen DOMHighResTimeStamp zurück, der den Beginn des Rendering-Zyklus angibt. Dieser umfasst Callbacks von Window.requestAnimationFrame(), Stil- und Layoutberechnungen sowie Callbacks von ResizeObserver und IntersectionObserver.

PerformanceLongAnimationFrameTiming.scripts Schreibgeschützt

Gibt ein Array von PerformanceScriptTiming-Instanzen zurück.

PerformanceLongAnimationFrameTiming.styleAndLayoutStart Schreibgeschützt

Gibt einen DOMHighResTimeStamp zurück, der den Beginn des Zeitraums angibt, in dem Stil- und Layoutberechnungen für den aktuellen Animationsframe durchgeführt werden.

Außerdem erweitert es die folgenden Eigenschaften von PerformanceEntry und konkretisiert beziehungsweise beschränkt sie wie beschrieben:

PerformanceEntry.duration Schreibgeschützt

Gibt einen DOMHighResTimeStamp zurück, der die für die vollständige Verarbeitung des LoAF benötigte Zeit in Millisekunden angibt.

PerformanceEntry.entryType Schreibgeschützt

Gibt den Eintragstyp zurück, der immer "long-animation-frame" ist.

PerformanceEntry.name Schreibgeschützt

Gibt den Eintragsnamen zurück, der immer "long-animation-frame" ist.

PerformanceEntry.startTime Schreibgeschützt

Gibt einen DOMHighResTimeStamp zurück, der den Zeitpunkt angibt, zu dem der Animationsframe begann.

Instanzmethoden

PerformanceLongAnimationFrameTiming.toJSON()

Gibt ein einfaches, als JSON serialisierbares Objekt zurück, das das PerformanceLongAnimationFrameTiming-Objekt repräsentiert. Die Methode wird automatisch von JSON.stringify() aufgerufen.

Beschreibung

Lange Animationsframes (LoAFs) sind Rendering-Aktualisierungen, die sich um mehr als 50 ms verzögern. LoAFs können dazu führen, dass die Benutzeroberfläche (UI) nur langsam aktualisiert wird. Dadurch können Bedienelemente den Eindruck erwecken, nicht zu reagieren, und Animationen sowie das Scrollen können ruckeln. Das frustriert häufig die Benutzer.

Das Interface PerformanceLongAnimationFrameTiming liefert die folgenden detaillierten Informationen zu LoAFs, mit denen Entwickler deren Ursachen eingrenzen können:

• Detaillierte Zeitstempel für jeden LoAF.
• Detaillierte Informationen zu jedem Skript, das zur Entstehung des LoAF beigetragen hat, über die Eigenschaft PerformanceLongAnimationFrameTiming.scripts. Sie gibt ein Array von PerformanceScriptTiming-Objekten zurück, eines für jedes Skript.

Beispiele

Beispiele zur Long Animation Frames API finden Sie unter Zeitmessung für lange Animationsframes.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Zeitmessung für lange Animationsframes
• PerformanceScriptTiming