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/assign/index.html | 68 +++++++++ files/ru/web/api/location/index.html | 205 +++++++++++++++++++++++++++ files/ru/web/api/location/reload/index.html | 73 ++++++++++ files/ru/web/api/location/replace/index.html | 68 +++++++++ 4 files changed, 414 insertions(+) create mode 100644 files/ru/web/api/location/assign/index.html create mode 100644 files/ru/web/api/location/index.html create mode 100644 files/ru/web/api/location/reload/index.html create mode 100644 files/ru/web/api/location/replace/index.html (limited to 'files/ru/web/api/location') diff --git a/files/ru/web/api/location/assign/index.html b/files/ru/web/api/location/assign/index.html new file mode 100644 index 0000000000..38cf76051a --- /dev/null +++ b/files/ru/web/api/location/assign/index.html @@ -0,0 +1,68 @@ +--- +title: Location.assign() +slug: Web/API/Location/assign +tags: + - API + - HTML-DOM + - Location + - Method + - Reference +translation_of: Web/API/Location/assign +--- +

{{ APIRef("HTML DOM") }}

+ +

Метод Location.assign() запускает загрузку и отображение нового документа по указанному URL.

+ +

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

+ +

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

+ +

Синтаксис

+ +
object.assign(url);
+
+ +

Параметры

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

Примеры

+ +
// Перейти на статью Location.reload
+document.location.assign('https://developer.mozilla.org/ru/docs/Web/API/Location.reload');
+ +

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

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

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

+ +

{{Compat("api.Location.assign")}}

+ +

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

+ + diff --git a/files/ru/web/api/location/index.html b/files/ru/web/api/location/index.html new file mode 100644 index 0000000000..470064d4b9 --- /dev/null +++ b/files/ru/web/api/location/index.html @@ -0,0 +1,205 @@ +--- +title: Location +slug: Web/API/Location +tags: + - API + - HTML DOM + - Interface + - Location + - Refernce +translation_of: Web/API/Location +--- +

{{APIRef("HTML DOM")}}

+ +

Интерфейс Location представляет собой адрес (URL) объекта, с которым он связан. Его модификации отражаются на родительском объекте. Интерфейсы {{domxref("Document")}} и {{domxref("Window")}} имеют подобный Location, к которому можно получить доступ через {{domxref("Document.location")}} и {{domxref("Window.location")}} соответственно.

+ +

Свойства

+ +

Интерфейс Location не имеет унаследованных свойств, но реализует свойства {{domxref("URLUtils")}}.

+ +
+
{{domxref("Location.href")}}
+
{{domxref("DOMString")}}, содержащий URL целиком. При изменении, соответствующий документ переходит на новую страницу.
+
{{domxref("Location.protocol")}}
+
{{domxref("DOMString")}}, содержащий протокол текущего URL, включая ':'.
+
{{domxref("Location.host")}}
+
{{domxref("DOMString")}}, содержащий хост, а именно имя хоста, ':' и порт.
+
{{domxref("Location.hostname")}}
+
{{domxref("DOMString")}}, содержащий домен текущего URL.
+
{{domxref("Location.port")}}
+
{{domxref("DOMString")}}, содержащий номер порта текущего URL.
+
{{domxref("Location.pathname")}}
+
{{domxref("DOMString")}}, содержащий первый '/' после хоста с последующим текстом URL.
+
{{domxref("Location.search")}}
+
{{domxref("DOMString")}}, содержащий '?' с последующими параметрами URL.
+ +
{{domxref("Location.hash")}}
+
{{domxref("DOMString")}}, содержащий '#' с последующим идентификатором.
+
{{domxref("Location.username")}}
+
{{domxref("DOMString")}}, содержащий имя пользователя, указанное перед именем домена.
+
{{domxref("Location.password")}}
+
{{domxref("DOMString")}}, содержащий пароль, указанный перед именем домена.
+
{{domxref("Location.origin")}} {{readOnlyInline}}
+
Возвращает {{domxref("DOMString")}}, содержащий протокол, хост и порт текущего URL.
+
+ +

Методы

+ +

Интерфейс Location не имеет унаследованных методов, но реализует методы {{domxref("URLUtils")}}.

+ +
+
{{domxref("Location.assign()")}}
+
Загружает ресурс по URL, указанному в качестве параметра.
+
{{domxref("Location.reload()")}}
+
Перезагружает ресурс по текущему URL. Единственный опциональный параметр {{domxref("Boolean")}} при значении true указывает, что страница должна быть заново загружена с сервера, при значении false страница может быть загружена из кэша.
+
{{domxref("Location.replace()")}}
+
Заменяет текущий ресурс на новый по URL, указанному в качестве параметра. Отличие от assign() в том, что при использовании replace() текущая страница не будет сохранена в {{domxref("History")}}, и пользователь не сможет использовать кнопку назад, чтобы вернуться к ней.
+
{{domxref("Location.toString()")}}
+
Возвращает {{domxref("DOMString")}}, содержащий URL целиком. Это синоним {{domxref("URLUtils.href")}}, однако он не может использоваться для изменения значения.
+
+ +

Примеры

+ +
// Этот пример создает ссылку и использует ее свойство href
+// Корректная альтернатива - использовать document.location или window.location текущего URL
+var url = document.createElement('a');
+url.href = 'https://developer.mozilla.org/en-US/search?q=URL#search-results-close-container';
+console.log(url.href);      // https://developer.mozilla.org/en-US/search?q=URL#search-results-close-container
+console.log(url.protocol);  // https:
+console.log(url.host);      // developer.mozilla.org
+console.log(url.hostname);  // developer.mozilla.org
+console.log(url.port);      // (пустой - https подразумевает порт 443)
+console.log(url.pathname);  // /en-US/search
+console.log(url.search);    // ?q=URL
+console.log(url.hash);      // #search-results-close-container
+console.log(url.origin);    // https://developer.mozilla.org
+
+ +

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

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

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

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
origin в Windows.location{{CompatUnknown}}{{CompatGeckoDesktop("21")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
origin во всех объектах location (кроме Workers, где используется {{domxref("WorkerLocation")}}){{CompatUnknown}}{{CompatGeckoDesktop("26")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
username и password{{CompatUnknown}}{{CompatGeckoDesktop("26")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ВозможностьAndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
origin в Windows.location{{CompatUnknown}}{{CompatGeckoMobile("21")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
origin во всех объектах location (кроме Workers, где используется {{domxref("WorkerLocation")}}){{CompatUnknown}}{{CompatGeckoMobile("26")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
username и password{{CompatUnknown}}{{CompatGeckoMobile("26")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

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

+ + diff --git a/files/ru/web/api/location/reload/index.html b/files/ru/web/api/location/reload/index.html new file mode 100644 index 0000000000..fb00e74ea7 --- /dev/null +++ b/files/ru/web/api/location/reload/index.html @@ -0,0 +1,73 @@ +--- +title: Location.reload() +slug: Web/API/Location/reload +tags: + - API + - HTML-DOM + - Location + - Method + - Reference +translation_of: Web/API/Location/reload +--- +

{{ APIRef("HTML DOM") }}

+ +

Метод Location.reload() перезагружает ресурс из текущего URL подобно кнопке обновления браузера.

+ +

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

+ +

Синтаксис

+ +
location.reload();
+
+ +

Примеры

+ +
// Перезагрузить текущую страницу
+document.location.reload();
+ +

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

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

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

+ +

{{Compat("api.Location.reload")}}

+ +

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

+ + + +
+
+
+
+ +
+ +
+
+ +
+
+
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