CKTIS / JavaScript
history.forward() — avançar no histórico
history.forward() avança uma entrada no histórico da sessão do navegador. Comporta-se como history.go(1); se não existir uma entrada seguinte, 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.forward()history.forward() não aceita argumentos e devolve undefined, não uma Promise. Comporta-se como history.go(1): pede a passagem para a entrada seguinte do histórico da sessão. Essa entrada pode pertencer ao mesmo documento ou a outra página; o método não cria uma entrada.
A passagem é assíncrona. Não leia o novo history.state imediatamente após a chamada. No exemplo, os eventos popstate sincronizam a passagem entre entradas do mesmo documento. pushState() não dispara popstate por si só.
Se não existir uma entrada seguinte, nada acontece. Um documento que não esteja totalmente ativo provoca um SecurityError; o navegador também pode bloquear o pedido de navegação. Esta é uma API do navegador definida por HTML, não uma funcionalidade de ECMAScript; a presença de Node 24 não comprova o seu suporte. A norma indica suporte em todos os motores de navegador atuais.
Exemplos
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
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.