History

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 ermöglicht die Manipulation der Sitzungsverlaufsgeschichte des Browsers, also der Seiten, die im Tab oder Frame besucht wurden, in dem die aktuelle Seite geladen ist.

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 in Worker- oder Worklet-Kontexten nicht zugegriffen werden.

Instanzeigenschaften

Das History-Interface erbt keine Eigenschaften.

length Nur lesbar

Gibt einen Integer zurück, der die Anzahl der Elemente im Sitzungsverlauf darstellt, einschließlich der aktuell geladenen Seite. Beispielsweise gibt diese Eigenschaft für eine in einem neuen Tab geladene Seite 1 zurück.

scrollRestoration

Ermöglicht Webanwendungen, das Standardverhalten der Bildlaufwiederherstellung bei Verlaufnavigation explizit festzulegen. Diese Eigenschaft kann entweder auto oder manual sein.

state Nur lesbar

Gibt einen any-Wert zurück, der den Zustand am oberen Ende des Verlaufsstapels darstellt. Dies ist eine Möglichkeit, sich den Zustand anzusehen, ohne auf ein popstate-Ereignis warten zu müssen.

Instanzmethoden

Das History-Interface erbt keine Methoden.

back()

Diese asynchrone Methode geht zur vorherigen Seite im Sitzungsverlauf zurück, wobei dieselbe Aktion ausgeführt wird, wie wenn der Benutzer auf die Zurück-Schaltfläche des Browsers klickt. Entspricht history.go(-1).

Der Aufruf dieser Methode, um über die erste Seite im Sitzungsverlauf hinaus zurückzugehen, hat keine Wirkung und löst keine Ausnahme aus.

forward()

Diese asynchrone Methode geht zur nächsten Seite im Sitzungsverlauf weiter, wobei dieselbe Aktion ausgeführt wird, wie wenn der Benutzer auf die Vorwärts-Schaltfläche des Browsers klickt; dies entspricht history.go(1).

Der Aufruf dieser Methode, um über die jüngste Seite im Sitzungsverlauf hinaus vorwärts zu gehen, hat 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, z.B. -1 für die vorherige Seite oder 1 für die nächste Seite. Wenn Sie einen ungültigen Wert angeben (z.B. -1, wenn es keine zuvor besuchten Seiten im Sitzungsverlauf gibt), hat diese Methode stillschweigend keine Wirkung. Der Aufruf von go() ohne Parameter oder mit dem Wert 0 lädt die aktuelle Seite neu.

pushState()

Schiebt die angegebenen Daten mit dem angegebenen Titel (und, falls bereitgestellt, URL) auf den Sitzungsverlaufsstapel. Die Daten werden vom DOM als opak 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. Weitere Informationen finden Sie unter Arbeiten mit der History API.

replaceState()

Aktualisiert den letzten Eintrag im Verlaufsstapel mit den angegebenen Daten, dem Titel und, falls bereitgestellt, der URL. Die Daten werden vom DOM als opak 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. Weitere Informationen finden Sie unter Arbeiten mit der History API.

Spezifikationen

Specification
HTML Standard
# the-history-interface

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch