CKTIS / JavaScript
Ciclo de vida de una página: visibilidad, salida y regreso
Distingue entre ocultar una pestaña, intentar salir de la página y restaurarla desde la caché de navegación para guardar, advertir o reanudar tareas en el momento adecuado.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
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.Estos cuatro eventos pertenecen a la plataforma web, no a ECMAScript 2024. Su compatibilidad y comportamiento varían según el navegador y la situación. No des por hecho que los cuatro se dispararán en un orden fijo.
Escucha visibilitychange en document. Este evento no se puede cancelar. Lee document.visibilityState (visible o hidden) o el booleano document.hidden. Cambiar de pestaña puede ocultar la página sin abandonarla. Guarda el estado a medida que se trabaja y toma el paso a hidden como la mejor señal para un último guardado o para pausar tareas, no como prueba de que la sesión terminó.
beforeunload en window es un BeforeUnloadEvent cancelable asociado a un intento de salir de la página, recargarla o cerrarla. Para solicitar confirmación, llama a event.preventDefault() y asigna a event.returnValue una cadena no vacía por compatibilidad con navegadores antiguos. Devolver un valor desde el manejador solo funciona con onbeforeunload, no con addEventListener(). El diálogo requiere una interacción previa válida del usuario (sticky activation); el navegador decide el texto y puede omitirlo. Registra el escuchador solo mientras haya cambios sin guardar y retíralo al guardarlos o descartarlos: puede impedir el uso de la bfcache, entre otros casos en Firefox.
pagehide y pageshow son eventos PageTransitionEvent no cancelables en window. Al salir, pagehide con event.persisted === true indica que el navegador pretende conservar el documento en memoria para navegar hacia atrás o adelante (bfcache), pero no garantiza que lo restaure. false indica que no pretende conservarlo. Usa pagehide para pausar recursos, no para guardar datos críticos: tanto este evento como beforeunload pueden faltar, por ejemplo si el sistema operativo móvil cierra el navegador en segundo plano.
En la carga inicial, pageshow se produce después de load y tiene persisted === false. Si vale true, el mismo documento se ha restaurado desde la bfcache: reanuda el trabajo pausado y actualiza los datos que puedan haber quedado obsoletos. pageshow no significa que el usuario vea la página; también puede dispararse en una pestaña en segundo plano.
Ejemplos
<!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>Resultado
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.
Abre el ejemplo como página HTML en el navegador y consulta la consola. `ready` aparece de inmediato; los mensajes posteriores dependen de tus acciones y del navegador. La casilla simula cambios sin guardar, pero no guarda nada.
Lecciones relacionadas
- JavaScript · Lección 35 · Avanzado · Versión: 4