CKTIS / JavaScript
history.go() — придвижване в историята на сесията
history.go(delta) използва отместване, измерено в брой записи в историята на сесията. Web IDL първо преобразува подадения аргумент в 32-битово цяло число със знак (long). Отрицателният резултат заявява придвижване назад, а положителният — напред. Ако резултатът е нула или аргументът е пропуснат, страницата се презарежда. Придвижването е асинхронно.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
history.go();
history.go(delta);history.go(delta) е уеб API на браузъра, дефиниран от HTML, а не функция на ECMAScript. Web IDL преобразува delta в 32-битово цяло число със знак (long). Полученото отместване задава посоката и броя стъпки. Например 4294967295 се преобразува в -1, затова history.go(4294967295) заявява придвижване с един запис назад. history.go(-1) съответства на history.back(), а history.go(1) — на history.forward(). Отместване извън обхвата не прави нищо; history.go(0) и history.go() презареждат страницата.
Методът връща undefined, а не Promise. Придвижването е асинхронно: кодът след извикването не трябва да приема, че целевият запис вече е активен. Придвижването може да остане в същия документ или да премине към друг. При показаното придвижване между записи, създадени с pushState(), прочетете състоянието в popstate.
Историята се състои от записи на сесията, а не само от отделни зареждания на страници; участие могат да вземат и рамки. Документ, който не е напълно активен, предизвиква SecurityError; ограниченията за навигация могат да блокират операцията. Съвременните браузърни енджини поддържат този API, но наличието на Node.js не доказва, че той е достъпен.
Примерът създава два записа в същия документ, след което се връща към първия. Стартирайте го на временна тестова страница: той променя историята и премахва евентуален съществуващ клон на историята напред.
Примери
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 });Резултат
step=1
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.