База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници