Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

history.back() — recuar no histórico da sessão

history.back() pede para recuar uma entrada no histórico da sessão do navegador. Comporta-se como history.go(-1); se não existir uma entrada anterior, não altera nada.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

history.back()

history.back() não aceita argumentos e devolve undefined, não uma Promise. A deslocação é assíncrona: a instrução seguinte não significa que tenha terminado. A entrada anterior pode pertencer ao mesmo documento ou a outro site.

Esta é uma API do navegador definida pelo HTML Standard, não uma funcionalidade ECMAScript. É suportada pelos motores de navegador atuais; a presença do Node 24 num projeto não comprova que esta API esteja disponível. Se for chamada para um documento que não esteja totalmente ativo, é lançado um SecurityError. O navegador também pode bloquear a operação.

No exemplo, pushState() cria duas entradas sem recarregar a página. Depois da deslocação, popstate disponibiliza o estado da entrada de destino. Não leias o resultado da deslocação imediatamente após history.back().

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes