History: state-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die state schreibgeschützte Eigenschaft der History-Schnittstelle gibt einen Wert zurück, der den Zustand an der Spitze des Verlaufstapels darstellt. Dies ist eine Möglichkeit, den Zustand zu betrachten, ohne auf ein popstate-Ereignis warten zu müssen.

Wert

Der Zustand an der Spitze des Verlaufstapels. Der Wert ist null, bis die Methode pushState() oder replaceState() verwendet wird.

Beispiele

Der untenstehende Code protokolliert den Wert von history.state bevor die Methode pushState() verwendet wird, um einen Wert in den Verlauf zu schieben. Die nächste Zeile protokolliert den Wert erneut in die Konsole und zeigt, dass history.state nun einen Wert hat.

js
// Should be null because we haven't modified the history stack yet
console.log("History.state before pushState: ", history.state);

// Now push something on the stack
history.pushState({ name: "Example" }, "pushState example", "page3.html");

// Now state has a value.
console.log("History.state after pushState: ", history.state);

Spezifikationen

Specification
HTML Standard
# dom-history-state-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch