CKTIS / HTML
onpopstate — gestionar cambios en la entrada activa del historial
El atributo onpopstate de body establece el controlador del evento popstate del objeto Window. Permite que una página responda al recorrido del historial de sesión, por ejemplo con Atrás y Adelante, y lea el estado de la entrada de destino.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<body onpopstate="handleState(event)">
window.onpopstate = handleState;onpopstate es un atributo controlador de eventos disponible en body, no un atributo global para cualquier elemento. Expone el controlador popstate del objeto Window. La asignación window.onpopstate = handleState establece ese mismo controlador; no crea un segundo listener independiente.
popstate está asociado al recorrido del historial de sesión, por ejemplo mediante Atrás, Adelante o history.back(). Llamar a history.pushState() o history.replaceState() por sí solo no dispara el evento. Dentro del controlador, event.state contiene el estado restaurado de la entrada de destino. Puede ser null, así que tenlo en cuenta antes de acceder a sus propiedades.
Una asignación posterior a window.onpopstate reemplaza el controlador anterior, y asignar null lo elimina. Para tener controladores independientes, usa window.addEventListener('popstate', handleState). No trates popstate como una forma de cancelar la navegación.
El ejemplo dispara deliberadamente un evento sintético PopStateEvent con un estado fijo. Comprueba la relación del atributo con Window, pero no modifica el historial ni prueba el recorrido real del historial. La CSP de una aplicación puede bloquear los atributos controladores inline; en ese caso, registra el controlador en un script permitido.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>onpopstate demo</title>
</head>
<body onpopstate="document.getElementById('result').textContent = 'step=' + event.state.step">
<button id="test" type="button">Test</button>
<output id="result">Ready</output>
<script>
document.getElementById('test').addEventListener('click', () => {
window.dispatchEvent(new PopStateEvent('popstate', {
state: { step: 1 }
}));
});
</script>
</body>
</html>Resultado
step=1
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.