Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

onpagehide — gestionar la salida de una página

El atributo onpagehide en body registra un controlador para el evento pagehide del objeto Window. En un evento generado por el navegador, el valor true de event.persisted indica que el navegador tiene intención de conservar el documento para una posible reutilización, no que lo conserve realmente.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<body onpagehide="JavaScript statements">

onpagehide es un atributo controlador de eventos para pagehide. Al colocarlo en body, gestiona el evento en Window, no un evento limitado a ese elemento. No es un atributo global disponible en cualquier elemento. El estándar también lo ofrece en el elemento histórico frameset. Su valor contiene instrucciones JavaScript; el objeto del evento está disponible como event.

El evento pagehide se refiere a salir de una página, no simplemente a cambiar de pestaña. En un evento generado por el navegador, la propiedad persisted del objeto PageTransitionEvent vale false cuando se abandona el documento definitivamente y true cuando el navegador tiene intención de conservarlo para una posible reutilización, por ejemplo, en la caché de navegación atrás/adelante (bfcache). El valor true no garantiza que el documento se conserve realmente ni que se restaure más adelante.

El equivalente en JavaScript es window.onpagehide = handler; la asignación reemplaza el controlador anterior de esa propiedad. window.addEventListener('pagehide', handler) permite registrar controladores independientes. El ejemplo envía un evento sintético para que el resultado sea reproducible: no abandona la página ni la coloca en bfcache.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onpagehide demo</title>
<body onpagehide="document.getElementById('result').textContent = event.type + ': persisted=' + event.persisted">
  <output id="result">Waiting</output>
  <script>
    window.dispatchEvent(new PageTransitionEvent('pagehide', {
      persisted: true
    }));
  </script>
</body>
</html>

Resultado

pagehide: persisted=true

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes