KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Zichtbaarheid van het document: `Document.hidden` en `visibilitychange`

Lees met `document.hidden` of het document nu zichtbaar is en reageer met `visibilitychange` op wijzigingen zonder de status steeds opnieuw op te vragen.

Versie: Current web platform; runtime support varies

Syntax

document.hidden
 document.visibilityState
 document.addEventListener("visibilitychange", listener)
 document.removeEventListener("visibilitychange", listener)

document.hidden is een alleen-lezen booleaanse eigenschap. De waarde is true als document.visibilityState gelijk is aan "hidden", en false als die "visible" is. Een tabblad op de achtergrond of een geminimaliseerd venster is een veelvoorkomende reden waarom het document verborgen is. De status geeft niet aan of de pagina de focus heeft, of een specifiek element zichtbaar is, of dat iemand naar de pagina kijkt.

De browser vuurt visibilitychange af op document nadat de status in een van beide richtingen verandert. Dit gewone Event bubbelt en kan niet worden geannuleerd. Het bevat de nieuwe status niet: lees de eigenschap in de listener. Registratie roept de listener niet meteen aan; lees de beginstatus daarom apart uit. Geef dezelfde functie door aan removeEventListener om de listener te verwijderen.

Je kunt bijvoorbeeld onnodige updates van de interface pauzeren zolang het document verborgen is, en ze hervatten zodra het weer zichtbaar is. Een overgang naar "hidden" betekent niet dat de pagina is gesloten. Reken er ook niet op dat de browser je code de tijd geeft om werk af te ronden. Deze API hoort bij het webplatform, niet bij ECMAScript. De beschikbaarheid hangt af van de uitvoeromgeving.

Voorbeelden

const stopVisibilityLog = (() => {
  const hasDocument = typeof document !== "undefined";
  const page = hasDocument ? document : new EventTarget();
  let simulatedHidden = false;

  if (!hasDocument) {
    // Node.js fixture: simulate visibility without a browser document.
    Object.defineProperty(page, "hidden", { get: () => simulatedHidden });
  }

  const logVisibility = () => {
    console.log(page.hidden ? "hidden" : "visible");
  };

  page.addEventListener("visibilitychange", logVisibility);
  logVisibility();

  const stop = () => {
    page.removeEventListener("visibilitychange", logVisibility);
  };

  if (!hasDocument) {
    const changeVisibility = (hidden) => {
      simulatedHidden = hidden;
      page.dispatchEvent(new Event("visibilitychange", { bubbles: true }));
    };

    changeVisibility(true);
    changeVisibility(false);
    stop();
    changeVisibility(true); // No log after removing the listener.
  }

  return stop;
})();

Resultaat

visible
hidden
visible

Voer de code één keer uit in de browserconsole van een zichtbare pagina. Wissel naar een ander tabblad en kom terug. De getoonde uitvoer gaat uit van precies die twee wijzigingen na de eerste uitlezing. Roep `stopVisibilityLog()` aan om te stoppen met loggen. In Node.js simuleert het voorbeeld wijzigingen in de zichtbaarheid zonder een browserdocument te gebruiken.

Gerelateerde lessen

  • JavaScript · Les 27 · Gemiddeld · Versie: 3
  • JavaScript · Les 29 · Gemiddeld · Versie: 3
  • JavaScript · Les 31 · Gemiddeld · Versie: 3

Bronnen