WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

PopStateEvent.state — Zustand des Verlaufseintrags

PopStateEvent.state liest den Zustand aus, der mit dem während eines popstate-Ereignisses aktivierten Verlaufseintrag verknüpft ist. Erfahre, was null bedeutet und warum das Speichern eines Zustands etwas anderes ist als die Navigation im Verlauf.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

event.state

PopStateEvent.state ist eine schreibgeschützte Eigenschaft, auf die über event.state zugegriffen wird. Bei einem Navigationsereignis enthält sie eine Kopie der Daten, die mit history.pushState() oder history.replaceState() im gerade aktivierten Eintrag gespeichert wurden, nicht im Eintrag, der verlassen wird. Fehlt ein gespeicherter Zustand, ist der Wert null; prüfe dies, bevor du auf Felder zugreifst.

Der Aufruf von history.pushState() oder history.replaceState() allein löst kein popstate aus. Das Ereignis tritt im Zusammenhang mit dem Durchlaufen des Verlaufs auf, zum Beispiel beim Betätigen der Zurück-Schaltfläche. Ein Browser kann eine vorherige Interaktion mit der Seite voraussetzen. Empfange das Ereignis in einer Anwendung mit window.addEventListener("popstate", handler) und stelle die Ansicht anhand von event.state wieder her.

Das Beispiel erstellt absichtlich zwei PopStateEvent-Objekte und übergibt sie direkt an eine Funktion. Es löst weder Ereignisse aus noch verändert es den Verlauf. Die Option state legt die Daten des ersten Objekts fest; wird sie weggelassen, ist der Wert null. Die erwarteten Zeilen sind {"page":2} und null.

Dies ist eine Browser-Web-API, die im HTML-Standard definiert ist, keine Funktion einer bestimmten ECMAScript-Ausgabe. MDN gibt an, dass die Eigenschaft seit Juli 2015 breit verfügbar ist und der im Beispiel verwendete Konstruktor seit August 2016. Dass ein Repository Node 24 enthält, belegt nicht die Unterstützung dieser Schnittstellen.

Beispiele

(() => {
  function describeState(event) {
    console.log(JSON.stringify(event.state));
  }

  describeState(new PopStateEvent("popstate", { state: { page: 2 } }));
  describeState(new PopStateEvent("popstate"));
})();

Ergebnis

{"page":2}
null

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen