VisibilityStateEntry
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Das VisibilityStateEntry
-Interface bietet Zeitmessungen für Änderungen des Sichtbarkeitsstatus einer Seite, d.h., wenn ein Tab vom Vordergrund in den Hintergrund wechselt oder umgekehrt.
Dies kann verwendet werden, um Sichtbarkeitsänderungen auf der Performance-Zeitleiste zu lokalisieren und sie mit anderen Performance-Einträgen wie "first-contentful-paint" zu vergleichen (siehe PerformancePaintTiming
).
Es gibt zwei wichtige Zeiten für Änderungen des Sichtbarkeitsstatus, über die diese API berichtet:
visible
: Die Zeit, wenn die Seite sichtbar wird (d.h. wenn ihr Tab in den Vordergrund wechselt).hidden
: Die Zeit, wenn die Seite verborgen wird (d.h. wenn ihr Tab in den Hintergrund wechselt).
Die Performance-Zeitleiste wird immer einen "visibility-state"
-Eintrag mit einem startTime
von 0
und einem name
, das den initialen Sichtbarkeitsstatus der Seite repräsentiert, enthalten.
Hinweis:
Wie andere Performance-APIs erweitert auch diese API PerformanceEntry
.
Instanz-Eigenschaften
Dieses Interface hat keine eigenen Eigenschaften, erweitert jedoch die Eigenschaften von PerformanceEntry
und qualifiziert und beschränkt sie wie folgt:
PerformanceEntry.entryType
Experimentell-
Gibt
"visibility-state"
zurück. PerformanceEntry.name
Experimentell-
Gibt entweder
"visible"
oder"hidden"
zurück. PerformanceEntry.startTime
Experimentell-
Gibt den
timestamp
zurück, zu dem die Änderung des Sichtbarkeitsstatus erfolgte. PerformanceEntry.duration
Experimentell-
Gibt 0 zurück.
Instanz-Methoden
Dieses Interface hat keine Methoden.
Beispiele
Grundlegende Verwendung
Die folgende Funktion könnte verwendet werden, um alle "visibility-state"
-Performance-Einträge in der Konsole als Tabelle zu protokollieren:
function getVisibilityStateEntries() {
const visibilityStateEntries =
performance.getEntriesByType("visibility-state");
console.table(visibilityStateEntries);
}
Korrelation von Sichtbarkeitsstatus-Änderungen mit der Paint-Zeit
Die folgende Funktion erhält eine Referenz zu allen "visibility-state"
-Einträgen und dem "first-contentful-paint"
-Eintrag und verwendet Array.some()
, um zu testen, ob einer der "hidden"
-Sichtbarkeits-Einträge vor dem ersten contentful paint auftrat:
function wasHiddenBeforeFirstContentfulPaint() {
const fcpEntry = performance.getEntriesByName("first-contentful-paint")[0];
const visibilityStateEntries =
performance.getEntriesByType("visibility-state");
return visibilityStateEntries.some(
(e) => e.startTime < fcpEntry.startTime && e.name === "hidden",
);
}
Spezifikationen
Specification |
---|
HTML Standard # the-visibilitystateentry-interface |
Browser-Kompatibilität
BCD tables only load in the browser