Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes