From 996ebd1c41727cdad43e5709e190132368d0bd9b Mon Sep 17 00:00:00 2001 From: Dima Koltovych Date: Mon, 27 Sep 2021 23:55:19 +0300 Subject: (ru) Add URL API translation (#2524) Co-authored-by: Maxim Postautov <54762420+mpstv@users.noreply.github.com> --- files/ru/web/api/url/index.html | 119 ------------------------------------- files/ru/web/api/url/index.md | 126 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 126 insertions(+), 119 deletions(-) delete mode 100644 files/ru/web/api/url/index.html create mode 100644 files/ru/web/api/url/index.md (limited to 'files/ru/web/api') diff --git a/files/ru/web/api/url/index.html b/files/ru/web/api/url/index.html deleted file mode 100644 index 3e34d0f948..0000000000 --- a/files/ru/web/api/url/index.html +++ /dev/null @@ -1,119 +0,0 @@ ---- -title: URL -slug: Web/API/URL -tags: - - API - - Experimental - - NeedsTranslation - - TopicStub - - URL API -translation_of: Web/API/URL ---- -
{{ApiRef("URL API")}} {{SeeCompatTable}}
- -

The URL interface represent an object providing static methods used for creating object URLs.

- -

When using a user agent where no constructor has been implemented yet, it is possible to access such an object using the {{domxref("Window.URL")}} properties (prefixed with Webkit-based browser as Window.webkitURL).

- -

{{AvailableInWorkers}}

- -

Свойства

- -

Implements properties defined in {{domxref("URLUtils")}}.

- -
-
{{domxref("URLUtils.href")}}
-
Is a {{domxref("DOMString")}} containing the whole URL.
-
{{domxref("URLUtils.protocol")}}
-
Is a {{domxref("DOMString")}} containing the protocol scheme of the URL, including the final ':'.
-
{{domxref("URLUtils.host")}}
-
Is a {{domxref("DOMString")}} containing the host, that is the hostname, a ':', and the port of the URL.
-
{{domxref("URLUtils.hostname")}}
-
Is a {{domxref("DOMString")}} containing the domain of the URL.
-
{{domxref("URLUtils.port")}}
-
Is a {{domxref("DOMString")}} containing the port number of the URL.
-
{{domxref("URLUtils.pathname")}}
-
Is a {{domxref("DOMString")}} containing an initial '/' followed by the path of the URL.
-
{{domxref("URLUtils.search")}}
-
Is a {{domxref("DOMString")}} containing a '?' followed by the parameters of the URL.
-
{{domxref("URLUtils.hash")}}
-
Is a {{domxref("DOMString")}} containing a '#' followed by the fragment identifier of the URL.
-
{{domxref("URLUtils.username")}}
-
Is a {{domxref("DOMString")}} containing the username specified before the domain name.
-
{{domxref("URLUtils.password")}}
-
Is a {{domxref("DOMString")}} containing the password specified before the domain name.
-
{{domxref("URLUtils.origin")}} {{readonlyInline}}
-
Returns a {{domxref("DOMString")}} containing the origin of the URL, that is its scheme, its domain and its port.
-
- -
-
{{domxref("URLUtils.searchParams")}}
-
Returns a {{domxref("URLSearchParams")}} object allowing to access the GET query arguments contained in the URL.
-
- -

Конструктор

- -
-
{{domxref("URL.URL", "URL()")}}
-
Creates and return a URL object composed from the given parameters.
-
- -

Методы

- -

The URL interface implements methods defined in {{domxref("URLUtils")}}.

- -
-
{{domxref("URLUtils.toString()")}}
-
Returns a {{domxref("DOMString")}} containing the whole URL. It is a synonym for {{domxref("URLUtils.href")}}, though it can't be used to modify the value.
-
- -

Статические методы

- -
-
{{domxref("URL.createObjectURL()")}}
-
Returns a {{domxref("DOMString")}} containing a unique blob URL, that is a URL with blob: as its scheme, followed by an opaque string uniquely identifying the object in the browser.
-
{{domxref("URL.revokeObjectURL()")}}
-
Revokes an object URL previously created using {{domxref("URL.createObjectURL()")}}.
-
- -

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

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('File API', '#creating-revoking', 'URL')}}{{Spec2('File API')}}Добавлены статические методы URL.createObjectURL(), URL.revokeObjectURL().
{{SpecName('URL', '#api', 'Node')}}{{Spec2('URL')}}Initial definition (implements URLUtils).
- -

Поддержка браузерами

- -

{{Compat("api.URL")}}

- -

Chrome Code - Scope Availability

- -

To use from chrome code, JSM and Bootstrap scope, you have to import it like this:

- -
Cu.importGlobalProperties(['URL']);
-
- -

URL is available in Worker scopes.

- -

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

- - diff --git a/files/ru/web/api/url/index.md b/files/ru/web/api/url/index.md new file mode 100644 index 0000000000..436945220b --- /dev/null +++ b/files/ru/web/api/url/index.md @@ -0,0 +1,126 @@ +--- +title: URL +slug: Web/API/URL +tags: + - API + - URL API + - URL + - URI + - Address + - Hostname + - Domain + - Адрес + - Домен +translation_of: Web/API/URL +--- +{{ApiRef("URL API")}} + +Интерфейс **`URL`** используется для разбора, создания, нормализации и кодирования {{glossary("URL", "URL-адресов")}}. Он предоставляет свойства, которые позволяют легко читать и изменять части URL-адреса. + +Для создания объекта `URL` нужно вызвать конструктор, передав ему строку с абсолютным или относительным URL-адресом в качестве аргумента. В случае с относительным адресом в конструктор также нужно передать базовый адрес вторым аргументом. После этого вы получите доступ к частям URL-адреса для их чтения или модификации. + +В случае, когда браузер не поддерживает {{domxref("URL.URL", "URL()")}} конструктор, вы можете получить доступ к объекту URL через {{domxref("URL")}} свойство интерфейса {{domxref("Window")}}. Проверьте, не нуждается ли какой-либо из ваших целевых браузеров в этом префиксе. + +{{AvailableInWorkers}} + +## Конструктор + +- {{domxref("URL.URL", "new URL()")}} + - : Создаёт и возвращает объект URL из указанного абсолютного адреса или пути и базового адреса. + +## Свойства + +- {{domxref("URL.hash", "hash")}} + - : Строка типа {{domxref("USVString")}}. Содержит идентификатор фрагмента и символ `'#'` в начале строки. +- {{domxref("URL.host", "host")}} + - : Строка типа {{domxref("USVString")}}. Содержит доменное имя (_hostname_) за которым следует (если был указан порт) символ `':'` и номер порта. +- {{domxref("URL.hostname", "hostname")}} + - : Строка типа {{domxref("USVString")}}. Содержит доменное имя. +- {{domxref("URL.href", "href")}} + - : Строка типа {{domxref("USVString")}}. Содержит полный URL-адрес. +- {{domxref("URL.origin", "origin")}} {{readonlyInline}} + - : Строка типа {{domxref("USVString")}}. Содержит схему (протокол), доменное имя и номера порта. +- {{domxref("URL.password", "password")}} + - : Строка типа {{domxref("USVString")}}. Содержит пароль, указанный перед доменным именем. +- {{domxref("URL.pathname", "pathname")}} + - : Строка типа {{domxref("USVString")}}. Содержит относительный пусть и символ `'/'` в начале строки. Параметры запроса и идентификатор фрагмента не входят в эту строку. +- {{domxref("URL.port", "port")}} + - : Строка типа {{domxref("USVString")}}. Содержит номер порта. +- {{domxref("URL.protocol", "protocol")}} + - : Строка типа {{domxref("USVString")}}. Содержит название протокола и символ `':'` на конце. +- {{domxref("URL.search", "search")}} + - : Строка типа {{domxref("USVString")}}. Содержит параметры запроса. Включает в себя все параметры, которые были указаны и начинается с символа `'?'`. +- {{domxref("URL.searchParams", "searchParams")}} {{readonlyInline}} + - : Объект {{domxref("URLSearchParams")}}. Позволяет получить доступ к каждому параметру запроса по отдельности. +- {{domxref("URL.username","username")}} + - : Строка типа {{domxref("USVString")}}. Содержит имя пользователя указанное перед именем домена. + +## Методы + +- {{domxref("URL.toString", "toString()")}} + - : Возвращает строку типа {{domxref("USVString")}}, содержащую полный URL-адрес. Возвращаемое значение аналогично значению свойства {{domxref("URL.href")}}. Разница лишь в том, что при помощи этого метода нельзя изменить значение URL-адреса. +- {{domxref("URL.toJSON", "toJSON()")}} + - : Возвращает строку типа {{domxref("USVString")}}, содержащую полный URL-адрес. Возвращаемое значение аналогично значению свойства {{domxref("URL.href")}}. + +## Статические методы + +- {{domxref("URL.createObjectURL", "createObjectURL()")}} + - : Возвращает строку типа {{domxref("DOMString")}}, содержащую уникальный URL-адрес `Blob` объекта. Этот адрес предоставляет из себя строку с `blob:` в качестве схемы, за которой идёт строка однозначно идентифицирующая `Blob` объект в браузере. +- {{domxref("URL.revokeObjectURL", "revokeObjectURL()")}} + - : Отменяет URL созданный при помощи {{domxref("URL.createObjectURL()")}}. + +## Примечания по использованию + +Конструктор принимает один обязательный параметр — `url` и один необязательный параметр — `base`, который будет использован в качестве «основы», если параметр `url` это относительный URL-адрес: + +```js +const url = new URL('../cats', 'http://www.example.com/dogs'); +console.log(url.hostname); // "www.example.com" +console.log(url.pathname); // "/cats" +``` + +Вы можете задавать значения свойствам объекта URL, чтобы изменять URL-адрес: + +```js +url.hash = 'tabby'; +console.log(url.href); // "http://www.example.com/cats#tabby" +``` + +URL-адреса кодируются согласно стандарту {{RFC(3986)}}. Например: + +```js +url.pathname = 'démonstration.html'; +console.log(url.href); // "http://www.example.com/d%C3%A9monstration.html" +``` + +Интерфейс {{domxref("URLSearchParams")}} можно использовать для работы с параметрами запроса. + +Например, следующим образом можно получить параметры запроса URL-адреса текущей веб-страницы: + +```js +// https://some.site/?id=123 +const parsedUrl = new URL(window.location.href); +console.log(parsedUrl.searchParams.get("id")); // "123" +``` + +Метод {{domxref("URL.toString", "toString()")}} лишь возвращает значение свойства {{domxref("URL.href", "href")}}. Благодаря этому, конструктор `URL` можно использовать для нормализации и кодирования URL-адреса. + +```js +const response = await fetch(new URL('http://www.example.com/démonstration.html')); +``` + +## Спецификации + +{{Specifications}} + +## Поддержка браузерами + +{{Compat}} + +## Смотрите также + +- Полифил для `URL` доступен в [core-js](https://github.com/zloirock/core-js#url-and-urlsearchparams) +- [URL API](/en-US/docs/Web/API/URL_API) +- [Что такое URL-адрес?](/en-US/docs/Learn/Common_questions/What_is_a_URL) +- Свойство для получения объекта `URL`: {{domxref("URL")}}. +- {{domxref("URLSearchParams")}}. -- cgit v1.2.3-54-g00ecf