Location.replace()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/ru/web/api/html_dom_api/index.md)
Метод Location.replace()
заменяет текущий ресурс на новый по URL, указанному в качестве параметра. Отличие от assign()
в том, что при использовании replace()
текущая страница не будет сохранена в History
, и пользователь не сможет использовать кнопку назад, чтобы вернуться к ней.
Если условия вызова метода не удовлетворяют требованиям безопасности, выбрасывается DOMException
с типом SECURITY_ERROR
. Это случается, если домен скрипта, вызывающего метод, не совпадает с доменом страницы, изначально содержащимся в Location
.
Если новый URL некорректен, выбрасывается DOMException
с типом SYNTAX_ERROR
.
Синтаксис
object.replace(url);
Параметры
Примеры
// Перейти на статью Location.reload, заменив текущую страницу
document.location.replace(
"https://developer.mozilla.org/ru/docs/Web/API/Location.reload",
);
Спецификации
Specification |
---|
HTML Standard # dom-location-replace-dev |
Совместимость с браузерами
BCD tables only load in the browser
Смотрите также
- Интерфейс
Location
, к которому принадлежит этот метод. - Похожие методы:
Location.assign()
иLocation.reload()
.