Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Document.hidden — lire la visibilité du document

Document.hidden est une propriété en lecture seule qui indique si le navigateur considère le document comme masqué. Suivez les changements avec visibilitychange.

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

Syntaxe

document.hidden

Document.hidden, lu sous la forme document.hidden, renvoie true lorsque document.visibilityState === "hidden" ; sinon, il renvoie false. Le fait de le lire ne masque pas la page.

Le navigateur détermine la visibilité en tenant compte, entre autres, du fait qu’un onglet soit en arrière-plan ou qu’une fenêtre soit réduite. Ne confondez pas cette propriété avec HTMLElement.hidden, qui contrôle l’état masqué d’un élément.

Écoutez l’événement visibilitychange sur document et lisez à nouveau la propriété. L’exemple affiche l’état de visibilité initial de la page courante dans le paragraphe status et met ce paragraphe à jour à chaque changement de visibilité. Seule la valeur de hidden du document créé séparément, sans lien avec la page courante, est écrite dans la console. Il s’agit d’une API Web décrite dans le HTML Standard, et non d’une fonctionnalité ECMAScript ; la présence de Node 24 ne garantit pas sa disponibilité.

Exemples

<!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>

Résultat

Detached document.hidden: true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources