(ru) Add URL API translation (#2524)

Co-authored-by: Maxim Postautov <54762420+mpstv@users.noreply.github.com>

2 files changed, 126 insertions, 119 deletions

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
----
-<div>{{ApiRef("URL API")}} {{SeeCompatTable}}</div>
-
-<p>The <strong><code>URL</code></strong><strong> </strong>interface represent an object providing static methods used for creating object URLs.</p>
-
-<p>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 <code>Window.webkitURL</code>).</p>
-
-<p>{{AvailableInWorkers}}</p>
-
-<h2 id="Свойства">Свойства</h2>
-
-<p><em>Implements properties defined in {{domxref("URLUtils")}}.</em></p>
-
-<dl>
- <dt>{{domxref("URLUtils.href")}}</dt>
- <dd>Is a {{domxref("DOMString")}} containing the whole URL.</dd>
- <dt>{{domxref("URLUtils.protocol")}}</dt>
- <dd>Is a {{domxref("DOMString")}} containing the protocol scheme of the URL, including the final <code>':'</code>.</dd>
- <dt>{{domxref("URLUtils.host")}}</dt>
- <dd>Is a {{domxref("DOMString")}} containing the host, that is the <em>hostname</em>, a <code>':'</code>, and the <em>port</em> of the URL.</dd>
- <dt>{{domxref("URLUtils.hostname")}}</dt>
- <dd>Is a {{domxref("DOMString")}} containing the domain of the URL.</dd>
- <dt>{{domxref("URLUtils.port")}}</dt>
- <dd>Is a {{domxref("DOMString")}} containing the port number of the URL.</dd>
- <dt>{{domxref("URLUtils.pathname")}}</dt>
- <dd>Is a {{domxref("DOMString")}} containing an initial <code>'/'</code> followed by the path of the URL.</dd>
- <dt>{{domxref("URLUtils.search")}}</dt>
- <dd>Is a {{domxref("DOMString")}} containing a <code>'?'</code> followed by the parameters of the URL.</dd>
- <dt>{{domxref("URLUtils.hash")}}</dt>
- <dd>Is a {{domxref("DOMString")}} containing a <code>'#'</code> followed by the fragment identifier of the URL.</dd>
- <dt>{{domxref("URLUtils.username")}}</dt>
- <dd>Is a {{domxref("DOMString")}} containing the username specified before the domain name.</dd>
- <dt>{{domxref("URLUtils.password")}}</dt>
- <dd>Is a {{domxref("DOMString")}} containing the password specified before the domain name.</dd>
- <dt>{{domxref("URLUtils.origin")}} {{readonlyInline}}</dt>
- <dd>Returns a {{domxref("DOMString")}} containing the origin of the URL, that is its scheme, its domain and its port.</dd>
-</dl>
-
-<dl>
- <dt>{{domxref("URLUtils.searchParams")}}</dt>
- <dd>Returns a {{domxref("URLSearchParams")}} object allowing to access the GET query arguments contained in the URL.</dd>
-</dl>
-
-<h2 id="Конструктор">Конструктор</h2>
-
-<dl>
- <dt>{{domxref("URL.URL", "URL()")}}</dt>
- <dd>Creates and return a <code>URL</code> object composed from the given parameters.</dd>
-</dl>
-
-<h2 id="Методы">Методы</h2>
-
-<p><em>The <code>URL</code> interface implements methods defined in {{domxref("URLUtils")}}.</em></p>
-
-<dl>
- <dt>{{domxref("URLUtils.toString()")}}</dt>
- <dd>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.</dd>
-</dl>
-
-<h2 id="Статические_методы">Статические методы</h2>
-
-<dl>
- <dt>{{domxref("URL.createObjectURL()")}}</dt>
- <dd>Returns a {{domxref("DOMString")}} containing a unique blob URL, that is a URL with <code>blob:</code> as its scheme, followed by an opaque string uniquely identifying the object in the browser.</dd>
- <dt>{{domxref("URL.revokeObjectURL()")}}</dt>
- <dd>Revokes an object URL previously created using {{domxref("URL.createObjectURL()")}}.</dd>
-</dl>
-
-<h2 id="Спецификации">Спецификации</h2>
-
-<table class="standard-table">
- <tbody>
-  <tr>
-   <th scope="col">Specification</th>
-   <th scope="col">Status</th>
-   <th scope="col">Comment</th>
-  </tr>
-  <tr>
-   <td>{{SpecName('File API', '#creating-revoking', 'URL')}}</td>
-   <td>{{Spec2('File API')}}</td>
-   <td>Добавлены статические методы <code>URL.createObjectURL()</code>, <code>URL.revokeObjectURL</code><code>()</code>.</td>
-  </tr>
-  <tr>
-   <td>{{SpecName('URL', '#api', 'Node')}}</td>
-   <td>{{Spec2('URL')}}</td>
-   <td>Initial definition (implements <code>URLUtils</code>).</td>
-  </tr>
- </tbody>
-</table>
-
-<h2 id="Поддержка_браузерами">Поддержка браузерами</h2>
-
-<p>{{Compat("api.URL")}}</p>
-
-<h2 id="Chrome_Code_-_Scope_Availability">Chrome Code - Scope Availability</h2>
-
-<p>To use from chrome code, JSM and Bootstrap scope, you have to import it like this:</p>
-
-<pre class="brush: js notranslate">Cu.importGlobalProperties(['URL']);
-</pre>
-
-<p><code>URL</code> is available in Worker scopes.</p>
-
-<h2 id="Смотрите_также">Смотрите также</h2>
-
-<ul>
- <li>Property allowing to get such an object: {{domxref("Window.URL")}}.</li>
- <li><a href="/en-US/docs/Components.utils.importGlobalProperties">Components.utils.importGlobalProperties</a></li>
-</ul>
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"</pre>
+```
+
+Вы можете задавать значения свойствам объекта 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")}}.