WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

history.back() — in der Sitzungschronik zurückgehen

history.back() fordert den Wechsel um einen Eintrag zurück in der Sitzungschronik des Browsers an. Die Methode verhält sich wie history.go(-1); gibt es keinen vorherigen Eintrag, ändert sich nichts.

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.back()

history.back() akzeptiert keine Argumente und gibt undefined zurück, nicht ein Promise. Der Wechsel erfolgt asynchron: Die nächste Anweisung bedeutet nicht, dass er bereits abgeschlossen ist. Der vorherige Eintrag kann zum selben Dokument oder zu einer anderen Website gehören.

Dies ist eine Browser-API aus dem HTML Standard, keine ECMAScript-Funktion. Sie wird von aktuellen Browser-Engines unterstützt; dass ein Projekt Node 24 verwendet, belegt nicht, dass diese API verfügbar ist. Wird sie für ein Dokument aufgerufen, das nicht vollständig aktiv ist, wird ein SecurityError ausgelöst. Der Browser kann den Vorgang außerdem blockieren.

Im Beispiel erstellt pushState() zwei Einträge, ohne die Seite neu zu laden. Nach dem Wechsel stellt popstate den Zustand des Zieleintrags bereit. Lies das Ergebnis des Wechsels nicht unmittelbar nach history.back() aus.

Beispiele

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

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

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

  history.back();
}, { once: true });

Ergebnis

demoStep: 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