Verlauf

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.

Das History Interface der History API erlaubt die Manipulation des Browser-Sitzungsverlaufs, also der Seiten, die im Tab oder Frame des aktuellen geladenen Dokuments besucht wurden.

Es gibt nur eine Instanz von history (es ist ein Singleton), die über das globale Objekt history zugänglich ist.

Hinweis: Dieses Interface ist nur im Haupt-Thread (Window) verfügbar. Es kann nicht in den Kontexten Worker oder Worklet aufgerufen werden.

Instanz-Eigenschaften

Das History Interface erbt keine Eigenschaften.

length Schreibgeschützt

Gibt eine Integer zurück, die die Anzahl der Elemente im Sitzungsverlauf angibt, einschließlich der aktuell geladenen Seite. Zum Beispiel gibt diese Eigenschaft für eine Seite, die in einem neuen Tab geladen wurde, 1 zurück.

scrollRestoration

Ermöglicht Webanwendungen, das Standardverhalten der Scroll-Restaurierung bei Verlauf-Navigation explizit festzulegen. Diese Eigenschaft kann entweder auto oder manual sein.

state Schreibgeschützt

Gibt einen any Wert zurück, der den Zustand an der Spitze des Verlaufstacks darstellt. Dies ist eine Möglichkeit, den Zustand zu betrachten, ohne auf ein popstate Ereignis warten zu müssen.

Instanz-Methoden

Das History Interface erbt keine Methoden.

back()

Diese asynchrone Methode geht zur vorherigen Seite im Sitzungsverlauf, vergleichbar mit der Aktion, wenn der Benutzer die Zurück-Taste des Browsers klickt. Entspricht history.go(-1).

Wenn diese Methode aufgerufen wird, um über die erste Seite im Sitzungsverlauf hinaus zurückzugehen, hat dies keine Wirkung und löst keine Ausnahme aus.

forward()

Diese asynchrone Methode geht zur nächsten Seite im Sitzungsverlauf, vergleichbar mit der Aktion, wenn der Benutzer die Vorwärts-Taste des Browsers klickt; dies entspricht history.go(1).

Wenn diese Methode aufgerufen wird, um über die zuletzt besuchte Seite im Sitzungsverlauf hinaus vorwärts zu gehen, hat dies keine Wirkung und löst keine Ausnahme aus.

go()

Lädt asynchron eine Seite aus dem Sitzungsverlauf, identifiziert durch ihre relative Position zur aktuellen Seite, zum Beispiel -1 für die vorherige Seite oder 1 für die nächste Seite. Wenn Sie einen ungültigen Wert angeben (zum Beispiel -1, wenn es keine zuvor besuchten Seiten im Sitzungsverlauf gibt), hat diese Methode stillschweigend keine Wirkung. Das Aufrufen von go() ohne Parameter oder mit einem Wert von 0 lädt die aktuelle Seite neu.

pushState()

Fügt die angegebenen Daten mit dem angegebenen Titel (und, falls bereitgestellt, der URL) dem Sitzungsverlauf-Stack hinzu. Die Daten werden vom DOM als undurchsichtig behandelt; Sie können jedes JavaScript-Objekt angeben, das serialisiert werden kann. Beachten Sie, dass alle Browser außer Safari derzeit den title-Parameter ignorieren. Für weitere Informationen siehe Arbeiten mit der History API.

replaceState()

Aktualisiert den zuletzt vorhandenen Eintrag im Verlaufs-Stack mit den angegebenen Daten, Titel und, falls bereitgestellt, der URL. Die Daten werden vom DOM als undurchsichtig behandelt; Sie können jedes JavaScript-Objekt angeben, das serialisiert werden kann. Beachten Sie, dass alle Browser außer Safari derzeit den title-Parameter ignorieren. Für weitere Informationen siehe Arbeiten mit der History API.

Spezifikationen

Specification
HTML
# the-history-interface

Browser-Kompatibilität

Siehe auch