CKTIS / JavaScript
visibilitychange — Änderungen der Dokument-Sichtbarkeit
Das Ereignis visibilitychange meldet eine Änderung der Sichtbarkeit des Dokuments. Den aktuellen Zustand kannst du über document.visibilityState abrufen.
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.addEventListener("visibilitychange", handler);visibilitychange ist ein Ereignis von document, das ausgelöst wird, nachdem sich dessen Sichtbarkeitsstatus geändert hat. document.visibilityState gibt "visible" oder "hidden" zurück; document.hidden ist das boolesche Gegenstück zum zweiten Wert.
Der Browser bestimmt die Sichtbarkeit, zum Beispiel beim Wechseln des Tabs oder beim Minimieren des Fensters. Das Ereignis wird nach oben weitergegeben. Du kannst es verwenden, um unnötige Arbeit auf einer ausgeblendeten Seite zu reduzieren.
Das Beispiel löst mit dispatchEvent ein einzelnes synthetisches visibilitychange-Ereignis aus, ohne den Tab zu wechseln oder die Sichtbarkeit des Dokuments zu ändern. Da der Listener mit once: true registriert ist, wird er nur einmal ausgeführt. Er kennzeichnet das Ereignis in der Konsole als synthetic und prüft, ob document.visibilityState den Wert "visible" oder "hidden" hat. Er gibt das boolesche Ergebnis (true) aus, nicht den Sichtbarkeitsstatus selbst.
Beispiele
<!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>Ergebnis
visibilitychange (synthetic): valid visibilityState = 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.