Location.replace()
Метод Location.replace() заменяет текущий ресурс на новый по URL, указанному в качестве параметра. Отличие от assign() в том, что при использовании replace() текущая страница не будет сохранена в History, и пользователь не сможет использовать кнопку назад, чтобы вернуться к ней.
Если условия вызова метода не удовлетворяют требованиям безопасности, выбрасывается DOMException (en-US) с типом SECURITY_ERROR. Это случается, если домен скрипта, вызывающего метод, не совпадает с доменом страницы, изначально содержащимся в Location.
Если новый URL некорректен, выбрасывается DOMException (en-US) с типом SYNTAX_ERROR.
Синтаксис
object.replace(url);
Параметры
- url
-
DOMString, содержащий URL страницы, на которую нужно перейти.
Примеры
js
// Перейти на статью Location.reload, заменив текущую страницу
document.location.replace('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload');
Спецификации
| Specification |
|---|
| HTML Standard # dom-location-replace-dev |
Совместимость с браузерами
BCD tables only load in the browser
Смотрите также
- Интерфейс
Location, к которому принадлежит этот метод. - Похожие методы:
Location.assign()иLocation.reload().