Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

history.back() — návrat v historii relace

history.back() požádá o návrat o jednu položku zpět v historii relace prohlížeče. Chová se jako history.go(-1); pokud předchozí položka neexistuje, nic se nezmění.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

history.back()

history.back() nepřijímá žádné argumenty a vrací undefined, nikoli Promise. Přechod je asynchronní: následující příkaz neznamená, že už byl dokončen. Předchozí položka může patřit stejnému dokumentu nebo jinému webu.

Jde o API prohlížeče definované v HTML Standard, nikoli o funkci ECMAScript. Podporují ho současné běhové prostředí prohlížečů; přítomnost Node 24 v projektu nedokládá, že je toto API dostupné. Při volání pro dokument, který není plně aktivní, se vyvolá SecurityError. Prohlížeč může operaci také zablokovat.

V příkladu vytvoří pushState() dvě položky bez opětovného načtení stránky. Po přechodu poskytne popstate stav cílové položky. Výsledek přechodu nečtěte bezprostředně po history.back().

Příklady

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 });

Výsledek

demoStep: 1

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje