CKTIS / JavaScript
history.pushState() — запис в историята без презареждане
history.pushState() обикновено добавя запис в историята на сесията, съхранява състояние и по избор променя 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.pushState(state, unused[, url]);history.pushState() е API на браузъра, дефиниран от HTML, а не от ECMAScript; съвременните браузърни енджини го поддържат. Наличието на Node 24 не доказва, че API е достъпен там. Методът обикновено добавя запис в историята на сесията, но при начален документ about:blank заменя текущия запис, вместо да добави нов. И в двата случая връща undefined, без да зарежда нов документ. За разлика от него history.replaceState() актуализира текущия запис, без да добавя нов.
state се сериализира, а не се запазва като препратка; можеш да го прочетеш чрез history.state. Функции не могат да се съхраняват по този начин и причиняват DataCloneError. Задължителният параметър unused обикновено получава стойността ''; той не задава заглавието на страницата.
Незадължителният url може да бъде относителен; ако го пропуснеш, адресът остава непроменен. При HTTP(S) страници той трябва да запази същия произход: схема, хост и порт. Недопустим URL, документ, който не е напълно активен, или прекалено чести извиквания могат да причинят SecurityError.
Извикването не задейства нито popstate, нито hashchange, дори когато фрагментът се промени. Актуализирай интерфейса сам; при навигация Назад/Напред обработвай popstate и event.state. Примерът показва, че последваща промяна на входния обект не променя съхраненото състояние.
Примери
(() => {
const state = { page: 2 };
const url = new URL(location.href);
url.hash = 'cktis-page-2';
const result = history.pushState(state, '', url.href);
state.page = 99;
console.log(JSON.stringify({
page: history.state.page,
hash: location.hash,
returnsUndefined: result === undefined
}));
})();Резултат
{"page":2,"hash":"#cktis-page-2","returnsUndefined":true}Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.