Location.replace()

Метод 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');

Спецификации

Спецификация Статус Комментарий
HTML Living Standard
Определение 'Location.replace()' в этой спецификации.
Живой стандарт Без изменений относительно HTML5.
HTML5
Определение 'Location.replace()' в этой спецификации.
Рекомендация Изначальное определение.

Совместимость с браузерами

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung Internet
replaceChrome Полная поддержка 1Edge Полная поддержка 12Firefox Полная поддержка 1IE Полная поддержка 5.5Opera Полная поддержка 3Safari Полная поддержка 1WebView Android Полная поддержка 1Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка 10.1Safari iOS Полная поддержка 1Samsung Internet Android Полная поддержка 1.0

Легенда

Полная поддержка  
Полная поддержка

Смотрите также