CKTIS / JavaScript
PopStateEvent.state — état de l’entrée d’historique
PopStateEvent.state permet de lire l’état associé à l’entrée d’historique activée lors d’un événement popstate. Découvrez ce que signifie null et pourquoi enregistrer un état est différent de naviguer dans l’historique.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
event.statePopStateEvent.state est une propriété en lecture seule, accessible via event.state. Lors d’un événement de navigation, elle contient une copie des données enregistrées par history.pushState() ou history.replaceState() dans l’entrée qui vient d’être activée, et non dans celle qui est quittée. En l’absence d’état enregistré, la valeur est null ; vérifiez-la avant de lire des champs.
L’appel de history.pushState() ou de history.replaceState() ne déclenche pas, à lui seul, popstate. Cet événement est associé au parcours de l’historique, par exemple lorsqu’on utilise le bouton Précédent. Le navigateur peut exiger une interaction préalable avec la page. Dans une application, écoutez-le avec window.addEventListener("popstate", handler) et restaurez l’affichage à partir de event.state.
L’exemple crée délibérément deux objets PopStateEvent et les transmet directement à une fonction. Il ne déclenche pas d’événements et ne modifie pas l’historique. L’option state fournit les données du premier objet ; si elle est omise, la valeur est null. Les lignes attendues sont {"page":2} et null.
Il s’agit d’une API Web du navigateur définie par la norme HTML, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. MDN indique que la propriété est largement disponible depuis juillet 2015 et que le constructeur utilisé dans l’exemple l’est depuis août 2016. La présence de Node 24 dans un dépôt ne prouve pas la prise en charge de ces interfaces.
Exemples
(() => {
function describeState(event) {
console.log(JSON.stringify(event.state));
}
describeState(new PopStateEvent("popstate", { state: { page: 2 } }));
describeState(new PopStateEvent("popstate"));
})();Résultat
{"page":2}
nullLe code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.