WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

history.go() — Sitzungsverlauf durchlaufen

history.go(delta) verwendet einen Versatz, der in Einträgen des Sitzungsverlaufs gemessen wird. Web IDL wandelt ein übergebenes Argument zunächst in eine vorzeichenbehaftete 32-Bit-Ganzzahl (long) um. Ein negatives Ergebnis fordert einen Wechsel zurück an, ein positives einen Wechsel nach vorn. Ergibt die Umwandlung 0 oder fehlt das Argument, wird die Seite neu geladen. Der Wechsel erfolgt asynchron.

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

history.go();
history.go(delta);

history.go(delta) ist eine Browser-Web-API, die in HTML definiert ist, keine ECMAScript-Funktion. Web IDL wandelt delta in eine vorzeichenbehaftete 32-Bit-Ganzzahl (long) um. Der so ermittelte Versatz gibt Richtung und Anzahl der Schritte an. Beispielsweise wird 4294967295 zu -1, sodass history.go(4294967295) einen Wechsel um einen Eintrag zurück anfordert. history.go(-1) entspricht history.back(), history.go(1) entspricht history.forward(). Ein Versatz außerhalb des verfügbaren Bereichs bewirkt nichts; history.go(0) und history.go() laden die Seite neu.

Die Methode gibt undefined zurück, nicht ein Promise. Der Wechsel erfolgt asynchron: Nachfolgender Code darf nicht davon ausgehen, dass der Zieleintrag bereits aktiv ist. Der Wechsel kann im selben Dokument bleiben oder zu einem anderen Dokument führen. Für den hier gezeigten Wechsel zwischen mit pushState() erstellten Einträgen kannst du den Zustand in popstate auslesen.

Der Verlauf besteht aus Sitzungseinträgen, nicht nur aus einzelnen Seitenaufrufen; auch Frames können daran beteiligt sein. Bei einem Dokument, das nicht vollständig aktiv ist, tritt SecurityError auf; Navigationsbeschränkungen können den Vorgang blockieren. Aktuelle Browser-Engines unterstützen diese API, doch die Verfügbarkeit von Node.js belegt nicht, dass sie dort verfügbar ist.

Das Beispiel erstellt zwei Einträge im selben Dokument und wechselt dann zum ersten zurück. Führe es auf einer entbehrlichen Testseite aus: Es verändert den Verlauf und verwirft einen eventuell vorhandenen Vorwärtszweig.

Beispiele

const button = document.createElement('button');
button.textContent = 'Run history demo';
document.body.append(button);

button.addEventListener('click', () => {
  button.disabled = true;
  history.pushState({ demoStep: 1 }, '');
  history.pushState({ demoStep: 2 }, '');

  window.addEventListener('popstate', (event) => {
    console.log(`step=${event.state.demoStep}`);
  }, { once: true });

  history.go(-1);
}, { once: true });

Ergebnis

step=1

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