Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

PopStateEvent : propriété state

Baseline
Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La propriété en lecture seule state de l'interface PopStateEvent représente l'état stocké lorsque l'évènement a été créé.

En pratique, il s'agit d'une valeur fournie par l'appel à history.pushState() ou history.replaceState()

Valeur

Un objet, ou null.

Exemples

Le code ci-dessous affiche la valeur de state lors de l'utilisation de la méthode pushState() pour ajouter une valeur à l'historique.

js
// Affiche l'état de
addEventListener("popstate", (event) => {
  console.log("État reçu : ", event.state);
});

// Pousse maintenant quelque chose sur la pile
history.pushState({ name: "Exemple" }, "exemple pushState", "page1.html");
history.pushState(
  { name: "Un autre exemple" },
  "un autre exemple",
  "page1.html",
);

Ça affiche :

État reçu : { name: "Exemple" }
État reçu : { name: "Un autre exemple" }

Spécifications

Spécification
HTML
# dom-popstateevent-state-dev

Compatibilité des navigateurs

Voir aussi