CKTIS / HTML
onpageswap — gestionar un documento saliente durante la navegación
El atributo onpageswap en body establece el controlador de Window para el evento pageswap. Este evento se refiere al documento saliente durante la navegación; no indica que haya aparecido una página nueva.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<body onpageswap="JavaScript statements">onpageswap es un atributo de contenido que contiene código JavaScript para un controlador del evento pageswap. En el elemento body, configura el controlador de Window, no un controlador independiente de ese elemento. No es un atributo booleano: su valor es código, y el parámetro event proporciona el evento.
El navegador puede enviar pageswap a la ventana del documento saliente cuando este deja de estar activo debido a la navegación. No es necesario que el documento se descargue: el evento también puede dispararse si el navegador lo conserva en la caché de navegación hacia atrás y hacia delante (bfcache). El evento real utiliza la interfaz PageSwapEvent; su propiedad viewTransition puede proporcionar una transición de vista o tener el valor null. No confundas este evento con pagereveal, que se refiere al inicio de la representación de un documento. pageswap no sirve para cancelar una navegación.
El atributo en body y la propiedad window.onpageswap configuran el mismo controlador: asignar una función nueva reemplaza la anterior. La alternativa window.addEventListener('pageswap', handler) añade controladores independientes sin reemplazar esa propiedad. La política Content Security Policy puede bloquear el código en los atributos; en ese caso, usa un script externo permitido.
El script del ejemplo solo muestra en la consola el resultado de dos comprobaciones: si body tiene el atributo onpageswap y si window expone la propiedad onpageswap. El script no dispara ningún evento ni inicia una navegación, así que el resultado no confirma que se ejecute el controlador definido en el atributo.
Ejemplos
<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Body onpageswap handler</title></head>
<body onpageswap="document.body.dataset.received = event.type">
<script>
console.log('onpageswap attribute present: ' + document.body.hasAttribute('onpageswap'));
console.log('onpageswap event property available: ' + ('onpageswap' in window));
</script>
</body>
</html>
Resultado
onpageswap attribute present: true onpageswap event property available: 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.