Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

history.forward() — avanzare nella cronologia

history.forward() avanza di una voce nella cronologia della sessione del browser. Si comporta come history.go(1); se non esiste una voce successiva, non cambia nulla.

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

Sintassi

history.forward()

history.forward() non accetta argomenti e restituisce undefined, non una Promise. Si comporta come history.go(1): richiede il passaggio alla voce successiva della cronologia della sessione. Questa voce può appartenere allo stesso documento o a un’altra pagina; il metodo non crea una voce.

Il passaggio è asincrono. Non leggere il nuovo history.state subito dopo la chiamata. Nell’esempio, gli eventi popstate sincronizzano il passaggio tra voci dello stesso documento. pushState() da solo non genera popstate.

Se non esiste una voce successiva, non succede nulla. Un documento che non è completamente attivo causa un SecurityError; il browser può anche bloccare la richiesta di navigazione. Questa è un’API del browser definita da HTML, non una funzionalità di ECMAScript; la presenza di Node 24 non ne dimostra il supporto. Lo standard indica il supporto in tutti i motori di browser attuali.

Esempi

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

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

  window.addEventListener('popstate', () => {
    console.log(history.state.step);
    window.addEventListener('popstate', () => {
      console.log(history.state.step);
      button.remove();
    }, { once: true });
    history.forward();
  }, { once: true });

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

Risultato

1
2

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti