CKTIS / JavaScript
PopStateEvent.state — estado de la entrada del historial
PopStateEvent.state permite leer el estado asociado a la entrada del historial activada durante un evento popstate. Descubre qué significa null y por qué guardar un estado es distinto de navegar por el historial.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
event.statePopStateEvent.state es una propiedad de solo lectura a la que se accede como event.state. En un evento de navegación, contiene una copia de los datos guardados mediante history.pushState() o history.replaceState() en la entrada que se acaba de activar, no en la que se abandona. Si no hay un estado guardado, el valor es null; compruébalo antes de leer campos.
Llamar a history.pushState() o history.replaceState() por sí solo no dispara popstate. Este evento está relacionado con el recorrido del historial, por ejemplo, al usar el botón Atrás. El navegador puede requerir una interacción previa con la página. En una aplicación, recibe el evento con window.addEventListener("popstate", handler) y restaura la vista usando event.state.
El ejemplo crea deliberadamente dos objetos PopStateEvent y se los pasa directamente a una función. No despacha eventos ni modifica el historial. La opción state proporciona los datos del primer objeto; si se omite, el valor es null. Las líneas esperadas son {"page":2} y null.
Esta es una API web del navegador definida por el estándar HTML, no una función de una edición concreta de ECMAScript. MDN indica que la propiedad está ampliamente disponible desde julio de 2015 y que el constructor usado en el ejemplo lo está desde agosto de 2016. Que un repositorio incluya Node 24 no demuestra que admita estas interfaces.
Ejemplos
(() => {
function describeState(event) {
console.log(JSON.stringify(event.state));
}
describeState(new PopStateEvent("popstate", { state: { page: 2 } }));
describeState(new PopStateEvent("popstate"));
})();Resultado
{"page":2}
nullEl 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.