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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.