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);

Параметры

url

DOMString , содержащий URL страницы, на которую нужно перейти.

Примеры

js
// Перейти на статью 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

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