CKTIS / JavaScript
history.go() — recorrer el historial de sesión
history.go(delta) usa un desplazamiento medido en entradas del historial de sesión. Web IDL convierte primero el argumento proporcionado en un entero de 32 bits con signo (long). Un resultado negativo solicita retroceder y uno positivo, avanzar. Si el resultado es cero o se omite el argumento, la página se recarga. El recorrido es asíncrono.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
history.go();
history.go(delta);history.go(delta) es una API web del navegador definida por HTML, no una función de ECMAScript. Web IDL convierte delta en un entero de 32 bits con signo (long). El desplazamiento obtenido indica la dirección y la cantidad de pasos. Por ejemplo, 4294967295 se convierte en -1, por lo que history.go(4294967295) solicita retroceder una entrada. history.go(-1) equivale a history.back(), y history.go(1) a history.forward(). Un desplazamiento fuera del intervalo no hace nada; history.go(0) y history.go() recargan la página.
El método devuelve undefined, no una Promise. El recorrido es asíncrono: el código posterior a la llamada no debe dar por hecho que la entrada de destino ya está activa. El recorrido puede permanecer en el mismo documento o pasar a otro. Para el recorrido mostrado entre entradas creadas con pushState(), lee el estado en popstate.
El historial consta de entradas de sesión, no solo de cargas de páginas distintas; los marcos también pueden participar. Un documento que no esté completamente activo provoca SecurityError; las restricciones de navegación pueden bloquear la operación. Los motores de navegador actuales admiten esta API, pero la presencia de Node.js no demuestra que esté disponible allí.
El ejemplo crea dos entradas del mismo documento y luego vuelve a la primera. Ejecútalo en una página de prueba desechable: modifica el historial y descarta cualquier rama existente del historial hacia delante.
Ejemplos
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 });Resultado
step=1
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.