[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/de/docs/Web/API/VisibilityStateEntry [Back]  [Original]

VisibilityStateEntry - Web-APIs | MDN

Dieser Inhalt wurde automatisch aus dem Englischen bersetzt, und kann Fehler enthalten. Erfahre mehr ber dieses Experiment.

View in English Always switch to English

VisibilityStateEntry

Eingeschrnkt verfgbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

Experimentell: Dies ist eine experimentelle Technologie
berprfen Sie die Browser-Kompatibilittstabelle sorgfltig vor der Verwendung auf produktiven Webseiten.

Die VisibilityStateEntry-Schnittstelle liefert Zeitangaben zu nderungen des Sichtbarkeitsstatus einer Seite, also dazu, wann ein Tab vom Vordergrund in den Hintergrund wechselt oder umgekehrt.

Damit lassen sich Sichtbarkeitsnderungen auf der Performance-Zeitleiste bestimmen und mit anderen Performance-Eintrgen wie "first-contentful-paint" abgleichen (siehe PerformancePaintTiming).

Diese API erfasst zwei wesentliche Zeitpunkte, zu denen sich der Sichtbarkeitsstatus ndert:

  • visible: Der Zeitpunkt, zu dem die Seite sichtbar wird (also wenn ihr Tab in den Vordergrund wechselt).
  • hidden: Der Zeitpunkt, zu dem die Seite ausgeblendet wird (also wenn ihr Tab in den Hintergrund wechselt).

Die Performance-Zeitleiste enthlt immer einen "visibility-state"-Eintrag mit einem startTime-Wert von 0 und einem name, der den anfnglichen Sichtbarkeitsstatus der Seite angibt.

Hinweis: Wie andere Performance-APIs erweitert auch diese API PerformanceEntry.

PerformanceEntry VisibilityStateEntry

In diesem Artikel

Instanzeigenschaften

Diese Schnittstelle hat keine eigenen Eigenschaften. Sie erweitert jedoch die Eigenschaften von PerformanceEntry, indem sie diese wie folgt konkretisiert und einschrnkt:

PerformanceEntry.entryType Schreibgeschtzt

Gibt "visibility-state" zurck.

PerformanceEntry.name Schreibgeschtzt

Gibt entweder "visible" oder "hidden" zurck.

PerformanceEntry.startTime Schreibgeschtzt

Gibt den Zeitstempel zurck, zu dem sich der Sichtbarkeitsstatus gendert hat.

PerformanceEntry.duration Schreibgeschtzt

Gibt 0 zurck.

Instanzmethoden

Diese Schnittstelle hat keine Methoden.

Beispiele

Grundlegende Verwendung

Mit der folgenden Funktion lsst sich eine Tabelle aller "visibility-state"-Performance-Eintrge in der Konsole ausgeben:

js
function getVisibilityStateEntries() {
  const visibilityStateEntries =
    performance.getEntriesByType("visibility-state");
  console.table(visibilityStateEntries);
}

Sichtbarkeitsnderungen mit Paint-Zeitangaben abgleichen

Die folgende Funktion ruft Referenzen auf alle "visibility-state"-Eintrge und den "first-contentful-paint"-Eintrag ab. Anschlieend prft sie mit Array.some(), ob einer der Sichtbarkeitseintrge mit dem Wert "hidden" vor dem ersten Contentful Paint aufgetreten ist:

js
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

Spezifikation
HTML
# the-visibilitystateentry-interface

Browser-Kompatibilitt

Siehe auch

Page Visibility API


Web Proxy Viewer  |  New URL  |  Original Page