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

CKTIS / JavaScript

history.go() — percorrer o histórico da sessão

history.go(delta) usa um desvio medido em entradas do histórico da sessão. Web IDL converte primeiro o argumento fornecido num inteiro de 32 bits com sinal (long). Um resultado negativo pede um recuo e um resultado positivo pede um avanço. Se o resultado for zero ou o argumento for omitido, a página é recarregada. O percurso é assíncrono.

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.go();
history.go(delta);

history.go(delta) é uma API Web do navegador definida por HTML, não uma função ECMAScript. Web IDL converte delta num inteiro de 32 bits com sinal (long). O desvio obtido indica a direção e o número de passos. Por exemplo, 4294967295 é convertido em -1, pelo que history.go(4294967295) pede um recuo de uma entrada. history.go(-1) corresponde a history.back() e history.go(1) a history.forward(). Um desvio fora do intervalo não produz efeitos; history.go(0) e history.go() recarregam a página.

O método devolve undefined, não uma Promise. O percurso é assíncrono: o código após a chamada não deve assumir que a entrada de destino já está ativa. O percurso pode permanecer no mesmo documento ou passar para outro. Para o percurso ilustrado entre entradas criadas por pushState(), lê o estado em popstate.

O histórico é constituído por entradas de sessão, não apenas por carregamentos de páginas distintos; os frames também podem participar. Um documento que não esteja totalmente ativo causa SecurityError; as restrições de navegação podem bloquear a operação. Os motores de navegador atuais suportam esta API, mas a presença de Node.js não comprova que esteja disponível.

O exemplo cria duas entradas no mesmo documento e, em seguida, recua para a primeira. Executa-o numa página de teste descartável: altera o histórico e elimina qualquer ramo existente do histórico para a frente.

Exemplos

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

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