Расположение: метод replace()

Базовая линия Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

Метод replace() интерфейса Location заменяет текущий ресурс ресурсом по указанному URL. Различие с методом assign() заключается в том, что после использования replace() текущая страница не сохраняется в истории History, что значит пользователь не сможет вернуться к ней с помощью кнопки Назад. Не путать с методом String String.prototype.replace().

Синтаксис

replace(url)

Параметры

url: Строка или любой другой объект со строковым преобразованием, например объект URL, содержащий URL страницы, на которую необходимо перейти.

Исключения

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

Возвращаемое значение

None (undefined).

Примеры

// Navigate to the Location.reload article by replacing this page
window.location.replace(
  "https://developer.mozilla.org/en-US/docs/Web/API/Location.reload",
);

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

Спецификация
HTML # dom-location-replace-dev

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`replace`	1	12	1	3	1	18	4	10.1	1	1.0	4.4

См. также

Интерфейс Location, к которому он принадлежит.
Аналогичные методы: Location.assign() и Location.reload().

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Location/replace