From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/ru/web/api/location/replace/index.html | 68 ++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 files/ru/web/api/location/replace/index.html (limited to 'files/ru/web/api/location/replace') diff --git a/files/ru/web/api/location/replace/index.html b/files/ru/web/api/location/replace/index.html new file mode 100644 index 0000000000..6019d603dc --- /dev/null +++ b/files/ru/web/api/location/replace/index.html @@ -0,0 +1,68 @@ +--- +title: Location.replace() +slug: Web/API/Location/replace +tags: + - API + - HTML-DOM + - Location + - Method + - Reference +translation_of: Web/API/Location/replace +--- +

{{ APIRef("HTML DOM") }}

+ +

Метод Location.replace() заменяет текущий ресурс на новый по URL, указанному в качестве параметра. Отличие от {{domxref("Location.assign","assign()")}} в том, что при использовании replace() текущая страница не будет сохранена в {{domxref("History")}}, и пользователь не сможет использовать кнопку назад, чтобы вернуться к ней.

+ +

Если условия вызова метода не удовлетворяют требованиям безопасности, выбрасывается {{domxref("DOMException")}} с типом SECURITY_ERROR. Это случается, если домен скрипта, вызывающего метод, не совпадает с доменом страницы, изначально содержащимся в {{domxref("Location")}}.

+ +

Если новый URL некорректен, выбрасывается {{domxref("DOMException")}} с типом SYNTAX_ERROR.

+ +

Синтаксис

+ +
object.replace(url);
+
+ +

Параметры

+ +
+
url
+
{{domxref("DOMString")}} , содержащий URL страницы, на которую нужно перейти.
+
+ +

Примеры

+ +
// Перейти на статью Location.reload, заменив текущую страницу
+document.location.replace('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload');
+ +

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

+ + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('HTML WHATWG', "history.html#dom-location-replace", "Location.replace()")}}{{Spec2('HTML WHATWG')}}Без изменений относительно {{SpecName("HTML5 W3C")}}.
{{SpecName('HTML5 W3C', "browsers.html#dom-location-replace", "Location.replace()")}}{{Spec2('HTML5 W3C')}}Изначальное определение.
+ +

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

+ +
{{Compat("api.Location.replace")}}
+ +

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

+ + -- cgit v1.2.3-54-g00ecf