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

CKTIS / JavaScript

history.replaceState — актуализиране на текущия запис в историята

history.replaceState актуализира състоянието и по избор URL адреса на текущия запис в историята, без да презарежда страницата. Не добавя запис и затова не създава допълнителна стъпка за бутона Назад.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

history.replaceState(data, unused)
history.replaceState(data, unused, url)

history.replaceState(data, unused, url) заменя състоянието на текущия запис; history.pushState добавя запис. Това е API на браузъра, дефиниран от HTML, а не функция на конкретно издание на ECMAScript. Наличието на Node 24 не доказва, че API е достъпен в браузъра.

Подайте "" като задължителния исторически аргумент unused; той не задава заглавието. Ако пропуснете url, адресът се запазва. Методът връща undefined. Не презарежда документа и сам по себе си не задейства popstate или hashchange.

data се клонира структурно за съхранение, а не се сериализира като JSON. Прочетете съхранената стойност чрез history.state; последваща промяна на входния обект не променя съхранената стойност. Функции и DOM възли не могат да се съхраняват по този начин и причиняват DataCloneError.

Правилата за пренаписване на URL адреса сравняват предложения URL адрес с текущия URL адрес на документа, а не с неговия произход (origin). Например документ на адрес about:blank може да промени фрагмента на своя URL адрес, дори ако наследява произхода си. Непозволен URL адрес, документ, който не е напълно активен, или ограничения на честотата на извикване могат да причинят SecurityError. Използвайте този метод, за да коригирате текущия изглед, а не за да създадете нова стъпка в навигацията.

Примери

(() => {
  const previousState = history.state;
  const previousURL = location.href;
  const previousLength = history.length;
  const data = { tab: "details" };
  const url = new URL(location.href);
  url.hash = "details";

  try {
    history.replaceState(data, "", url.href);
    data.tab = "changed";
    console.log(history.state.tab);
    console.log(location.hash);
    console.log(history.length === previousLength);
  } finally {
    history.replaceState(previousState, "", previousURL);
  }
})();

Резултат

details
#details
true

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

Източници