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.