Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

history.go() — attraversare la cronologia della sessione

history.go(delta) usa uno spostamento misurato in voci della cronologia della sessione. Web IDL converte prima l’argomento fornito in un intero con segno a 32 bit (long). Un risultato negativo richiede di tornare indietro, uno positivo di andare avanti. Se il risultato è zero o l’argomento è omesso, la pagina viene ricaricata. Lo spostamento è asincrono.

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.go();
history.go(delta);

history.go(delta) è un’API Web del browser definita da HTML, non una funzione ECMAScript. Web IDL converte delta in un intero con segno a 32 bit (long). Lo spostamento ottenuto indica direzione e numero di passaggi. Ad esempio, 4294967295 viene convertito in -1, quindi history.go(4294967295) richiede di tornare indietro di una voce. history.go(-1) corrisponde a history.back(), mentre history.go(1) corrisponde a history.forward(). Uno spostamento fuori dall’intervallo non produce effetti; history.go(0) e history.go() ricaricano la pagina.

Il metodo restituisce undefined, non una Promise. L’attraversamento è asincrono: il codice successivo alla chiamata non deve presumere che la voce di destinazione sia già attiva. L’attraversamento può restare nello stesso documento o passare a un altro. Per l’attraversamento illustrato tra voci create con pushState(), leggi lo stato in popstate.

La cronologia è composta da voci di sessione, non solo da caricamenti di pagina distinti; possono parteciparvi anche i frame. Un documento che non è completamente attivo causa SecurityError; le restrizioni di navigazione possono bloccare l’operazione. I motori dei browser attuali supportano questa API, ma la presenza di Node.js non ne dimostra la disponibilità.

L’esempio crea due voci nello stesso documento e poi torna alla prima. Eseguilo su una pagina di prova sacrificabile: modifica la cronologia ed elimina qualsiasi ramo esistente della cronologia in avanti.

Esempi

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

Risultato

step=1

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