Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

visibilitychange — zmiana widoczności dokumentu

Zdarzenie visibilitychange informuje o zmianie widoczności dokumentu. Aktualny stan odczytasz z document.visibilityState.

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

Składnia

document.addEventListener("visibilitychange", handler);

visibilitychange jest zdarzeniem obiektu document, emitowanym po zmianie jego stanu widoczności. document.visibilityState zwraca "visible" albo "hidden"; document.hidden jest logicznym odpowiednikiem drugiej wartości.

O widoczności decyduje przeglądarka, np. przy zmianie karty lub minimalizacji okna. Zdarzenie propaguje się w górę. Można go użyć do ograniczenia zbędnej pracy ukrytej strony.

Przykład wywołuje jedno syntetyczne zdarzenie visibilitychange za pomocą dispatchEvent, bez przełączania kart i bez zmiany widoczności dokumentu. Dzięki opcji once: true funkcja obsługi uruchamia się tylko raz. W konsoli oznacza zdarzenie jako synthetic i wypisuje wynik sprawdzenia, czy document.visibilityState ma wartość "visible" lub "hidden". Wypisuje true, a nie sam stan widoczności.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Testing a visibilitychange listener</title>
</head>
<body>
<script>
  document.addEventListener('visibilitychange', (event) => {
    // In normal use, read the current state when the browser fires this event.
    const state = document.visibilityState;
    const valid = state === 'visible' || state === 'hidden';
    console.log(`${event.type} (${event.isTrusted ? 'browser' : 'synthetic'}): valid visibilityState = ${valid}`);
  }, { once: true });

  // Exercise the listener without switching tabs or changing visibility.
  document.dispatchEvent(new Event('visibilitychange'));
</script>
</body>
</html>

Wynik

visibilitychange (synthetic): valid visibilityState = true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła