WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Document.hidden — Sichtbarkeit des Dokuments abfragen

Document.hidden ist eine schreibgeschützte Eigenschaft, die angibt, ob der Browser das Dokument als verborgen betrachtet. Änderungen lassen sich über visibilitychange verfolgen.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

document.hidden

Document.hidden, ausgelesen als document.hidden, gibt true zurück, wenn document.visibilityState === "hidden" gilt; andernfalls wird false zurückgegeben. Das Auslesen blendet die Seite nicht aus.

Der Browser bestimmt die Sichtbarkeit und berücksichtigt dabei unter anderem, ob ein Tab im Hintergrund oder ein Fenster minimiert ist. Verwechsle diese Eigenschaft nicht mit HTMLElement.hidden, das den verborgenen Zustand eines Elements steuert.

Höre auf visibilitychange bei document und lies die Eigenschaft erneut aus. Das Beispiel zeigt den anfänglichen Sichtbarkeitszustand der aktuellen Seite im Absatz status an und aktualisiert diesen Absatz bei jeder Änderung der Sichtbarkeit. In der Konsole gibt es nur den hidden-Wert des separat erstellten, nicht mit der aktuellen Seite verbundenen Dokuments aus. Dies ist eine im HTML Standard beschriebene Web-API und kein ECMAScript-Feature; dass Node 24 vorhanden ist, belegt nicht, dass die API verfügbar ist.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document.hidden</title>
</head>
<body>
  <h1>Document visibility</h1>
  <p id="status" role="status"></p>
  <script>
    const detached = document.implementation.createHTMLDocument('Detached example');
    console.log('Detached document.hidden: ' + detached.hidden);

    const status = document.getElementById('status');
    function showVisibility() {
      status.textContent = document.hidden ? 'This page is hidden.' : 'This page is visible.';
    }
    document.addEventListener('visibilitychange', showVisibility);
    showVisibility();
  </script>
</body>
</html>

Ergebnis

Detached document.hidden: true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen