Эта статья нуждается в техническом обзоре. Как вы можете помочь.
Метод Location.replace() заменяет текущий ресурс на новый по URL, указанному в качестве параметра. Отличие от assign() в том, что при использовании replace() текущая страница не будет сохранена в History, и пользователь не сможет использовать кнопку назад, чтобы вернуться к ней.
Если условия вызова метода не удовлетворяют требованиям безопасности, выбрасывается DOMException с типом SECURITY_ERROR. Это случается, если домен скрипта, вызвающего метод, не совпадает с доменом страницы, изначально содержащимся в Location.
Если новый URL некорректен, выбрасывается DOMException с типом SYNTAX_ERROR.
Синтаксис
object.replace(url);
Параметры
- url
DOMString, содержащий URL страницы, на которую нужно перейти.
Примеры
// Перейти на статью Location.reload, заменив текущую страницу
document.location.replace('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload');
Спецификации
| Спецификация | Статус | Комментарий |
|---|---|---|
| WHATWG HTML Living Standard Определение 'Location.replace()' в этой спецификации. |
Живой стандарт | Без изменений относительно HTML5. |
| HTML5 Определение 'Location.replace()' в этой спецификации. |
Рекомендация | Изначальное определение. |
Совместимость с браузерами
| Возможность | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Базовая поддержка | (Да) | (Да) | (Да) | (Да) | (Да) |
| Возможность | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Базовая поддержка | (Да) | (Да) | (Да) | (Да) | (Да) | (Да) |
Смотрите также
- Интерфейс
Location, к которому принадлежит этот метод. - Похожие методы:
Location.assign()иLocation.reload().