CKTIS / JavaScript
Seitenlebenszyklus: Sichtbarkeit, Verlassen und Rückkehr
Unterscheide einen ausgeblendeten Tab vom versuchten Verlassen der Seite und von der Wiederherstellung aus dem Vor-/Zurück-Cache, um passend darauf zu reagieren.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
document.addEventListener('visibilitychange', onVisibilityChange); // Read document.visibilityState or document.hidden.
window.addEventListener('beforeunload', onBeforeUnload); // Register only while unsaved changes exist.
window.removeEventListener('beforeunload', onBeforeUnload); // Remove the same listener once changes are saved or discarded.
window.addEventListener('pagehide', onPageHide); // Read event.persisted.
window.addEventListener('pageshow', onPageShow); // Read event.persisted.Diese vier Ereignisse gehören zur Webplattform, nicht zu ECMAScript 2024. Unterstützung und Verhalten hängen vom Browser und der Situation ab. Verlass dich nicht darauf, dass alle vier Ereignisse in einer festen Reihenfolge eintreten.
Registriere visibilitychange auf document. Das Ereignis ist nicht abbrechbar. Lies document.visibilityState (visible oder hidden) oder den booleschen Wert document.hidden. Ein Tabwechsel kann die Seite ausblenden, ohne dass du sie verlässt. Speichere den Zustand laufend und nutze den Wechsel zu hidden als bestes Signal für eine letzte Zwischenspeicherung oder zum Pausieren, nicht als Beleg für das Sitzungsende.
beforeunload auf window ist ein abbrechbares BeforeUnloadEvent, das mit dem versuchten Verlassen, Neuladen oder Schließen der Seite zusammenhängt. Um eine Bestätigung anzufordern, rufe event.preventDefault() auf und setze event.returnValue aus Kompatibilitätsgründen auf eine nicht leere Zeichenfolge. Ein Rückgabewert des Handlers wirkt nur über onbeforeunload, nicht über addEventListener(). Der Dialog erfordert eine geeignete vorherige Nutzerinteraktion (sticky activation); der Browser kann ihn unterdrücken und bestimmt den Text. Registriere den Listener nur bei ungespeicherten Änderungen und entferne ihn nach dem Speichern oder Verwerfen: Er kann den bfcache verhindern, unter anderem in Firefox.
pagehide und pageshow sind nicht abbrechbare PageTransitionEvent-Ereignisse auf window. Beim Verlassen bedeutet pagehide mit event.persisted === true, dass der Browser das Dokument für die Vor-/Zurück-Navigation im Speicher behalten will (bfcache). Eine Wiederherstellung ist nicht garantiert. false bedeutet, dass der Browser dies nicht beabsichtigt. Nutze pagehide, um Ressourcen zu pausieren, nicht um kritische Daten zu speichern: Sowohl dieses Ereignis als auch beforeunload können ausbleiben, etwa wenn ein mobiles Betriebssystem den Browser im Hintergrund beendet.
Beim ersten Laden folgt pageshow auf load und hat persisted === false. true bedeutet, dass dasselbe Dokument tatsächlich aus dem bfcache wiederhergestellt wurde: Setze pausierte Arbeit fort und aktualisiere möglicherweise veraltete Daten. pageshow bedeutet nicht, dass die Seite für die Nutzer sichtbar ist; es kann auch in einem Hintergrundtab eintreten.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Page lifecycle events</title>
</head>
<body>
<label><input id="dirty" type="checkbox" autocomplete="off"> Simulate unsaved changes</label>
<script>
const dirty = document.getElementById('dirty');
function warn(event) {
console.log('beforeunload');
event.preventDefault();
event.returnValue = 'unsaved'; // Legacy compatibility, not dialog text.
}
dirty.addEventListener('change', () => {
if (dirty.checked) {
window.addEventListener('beforeunload', warn);
} else {
window.removeEventListener('beforeunload', warn);
}
});
document.addEventListener('visibilitychange', () => {
console.log(`visibilitychange: ${document.visibilityState}`);
});
for (const type of ['pagehide', 'pageshow']) {
window.addEventListener(type, (event) => {
console.log(`${type}: persisted=${event.persisted}`);
});
}
console.log('ready');
</script>
</body>
</html>Ergebnis
ready Then, for example, after switching away from the tab and back: visibilitychange: hidden visibilitychange: visible Other lines (not guaranteed and not in a fixed cross-event order): beforeunload pagehide: persisted=true pageshow: persisted=true A dispatched page transition event can also report persisted=false.
Öffne das Beispiel als HTML-Seite im Browser und sieh in die Konsole. `ready` erscheint sofort; spätere Ausgaben hängen von deinen Aktionen und vom Browser ab. Das Kontrollkästchen simuliert ungespeicherte Änderungen, speichert aber nichts.
Zugehörige Lektionen
- JavaScript · Lektion 35 · Fortgeschritten · Version: 4