CKTIS / JavaScript
history.forward() — avanzar en el historial
history.forward() avanza una entrada en el historial de sesión del navegador. Se comporta como history.go(1); si no hay una entrada siguiente, no cambia nada.
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.forward()history.forward() no acepta argumentos y devuelve undefined, no una Promise. Se comporta como history.go(1): solicita pasar a la siguiente entrada del historial de sesión. Esa entrada puede pertenecer al mismo documento o a otra página; el método no crea ninguna entrada.
El recorrido es asíncrono. No leas el nuevo history.state inmediatamente después de llamar al método. En el ejemplo, los eventos popstate sincronizan el recorrido entre entradas del mismo documento. pushState() por sí solo no dispara popstate.
Si no hay una entrada siguiente, no ocurre nada. Un documento que no esté completamente activo provoca un SecurityError; el navegador también puede bloquear la solicitud de navegación. Esta es una API del navegador definida por HTML, no una característica de ECMAScript; disponer de Node 24 no demuestra que sea compatible. El estándar indica que es compatible con todos los motores de navegador actuales.
Ejemplos
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 });Resultado
1 2
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.