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.