История: метод replaceState()

Метод replaceState() интерфейса History изменяет текущую запись истории, заменяя её объектом состояния и URL, переданными в параметрах метода. Этот метод особенно полезен, когда необходимо обновить объект состояния или URL текущей записи истории в ответ на какое-либо действие пользователя.

state

Объект, связанный с записью истории, переданной методу replaceState(). Объект состояния может быть null.

unused

Этот параметр существует по историческим причинам и не может быть опущен; передача пустой строки является традиционной и безопасной против будущих изменений метода.

url Необязательно

URL записи истории. Новый URL должен быть того же происхождения, что и текущий URL; в противном случае метод replaceState() вызывает исключение.

None (undefined).

SecurityError DOMException

Вызывается, если связанный документ не полностью активен или переданный параметр url не является допустимым URL. Браузеры также ограничивают навигацию и могут вызвать эту ошибку, сгенерировать предупреждение или проигнорировать вызов, если он слишком часто вызывается.

DataCloneError DOMException

Вызывается, если переданный параметр state не сериализуем.

Предположим, https://www.mozilla.org/foo.html выполняет следующий JavaScript:

const stateObj = { foo: "bar" };
history.pushState(stateObj, "", "bar.html");

На следующей странице вы можете использовать history.state для доступа к stateObj, который только что был добавлен.

Объяснение этих двух строк выше можно найти в статье Работа с API истории. Затем предположим, что https://www.mozilla.org/bar.html выполняет следующий JavaScript:

history.replaceState(stateObj, "", "bar2.html");

Это приведет к отображению в строке URL https://www.mozilla.org/bar2.html, но не приведет к загрузке браузером bar2.html или даже к проверке существования bar2.html.

Предположим теперь, что пользователь переходит на https://www.microsoft.com, затем нажимает кнопку "Назад". В этот момент в строке URL будет отображаться https://www.mozilla.org/bar2.html. Если пользователь снова нажмёт "Назад", в строке URL будет отображаться https://www.mozilla.org/foo.html, и полностью пропустит страницу bar.html.