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

CKTIS / JavaScript

history.back() — retroceder en el historial de sesión

history.back() solicita retroceder una entrada en el historial de sesión del navegador. Se comporta como history.go(-1); si no hay una entrada anterior, 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.back()

history.back() no acepta argumentos y devuelve undefined, no una Promise. El desplazamiento es asíncrono: la siguiente instrucción no significa que haya terminado. La entrada anterior puede pertenecer al mismo documento o a otro sitio web.

Esta es una API del navegador definida por HTML Standard, no una función de ECMAScript. Está disponible en los motores de navegador actuales; que un proyecto use Node 24 no demuestra que esta API esté disponible. Si se llama para un documento que no está completamente activo, se produce un SecurityError. El navegador también puede bloquear la operación.

En el ejemplo, pushState() crea dos entradas sin recargar la página. Después del desplazamiento, popstate proporciona el estado de la entrada de destino. No leas el resultado del desplazamiento inmediatamente después de history.back().

Ejemplos

const button = document.createElement('button');
button.textContent = 'Run history.back()';
document.body.append(button);

button.addEventListener('click', () => {
  button.disabled = true;
  history.pushState({ demoStep: 1 }, '');
  history.pushState({ demoStep: 2 }, '');

  window.addEventListener('popstate', (event) => {
    console.log(`demoStep: ${event.state.demoStep}`);
    button.remove();
  }, { once: true });

  history.back();
}, { once: true });

Resultado

demoStep: 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.

Fuentes