(ru) Add URL constructor translation (#2538)

* Actualize content

* Add translation for the URL constructor page

* Change format to markdown

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

2 files changed, 81 insertions, 75 deletions

diff --git a/files/ru/web/api/url/url/index.html b/files/ru/web/api/url/url/index.html
deleted file mode 100644
index 7c8566b7d0..0000000000
--- a/files/ru/web/api/url/url/index.html
+++ /dev/null
@@ -1,75 +0,0 @@
----
-title: URL()
-slug: Web/API/URL/URL
-translation_of: Web/API/URL/URL
----
-<p>{{SeeCompatTable}}{{APIRef("URL API")}}</p>
-
-<p>Конструктор <code><strong>URL()</strong></code> возвращает вновь созданный  {{domxref("URL")}} объект отражающий URL определяемый параметрами.</p>
-
-<p>If the given base URL or the resulting URL are not valid URLs, a {{domxref("DOMException")}} of type <code>SYNTAX_ERROR</code> is thrown.</p>
-
-<p>{{AvailableInWorkers}}</p>
-
-<h2 id="Синтаксис">Синтаксис</h2>
-
-<pre class="syntaxbox"><em>url</em> = new URL(<em>urlString</em>, [<em>baseURLstring</em>])
-<em>url</em> = new URL(<em>urlString</em>, <em>baseURLobject</em>)
-</pre>
-
-<h3 id="Параметры">Параметры</h3>
-
-<dl>
- <dt><em>urlString</em></dt>
- <dd>Is a {{domxref("DOMString")}} representing an absolute or relative URL. If <em>urlString</em> is a relative URL, <em>baseURLstring</em> or <em>baseURLobject</em>, whichever is present, will be used as the base URL. If <em>urlString</em> is an absolute URL, <em>baseURLstring</em> and <em>baseURLobject</em> are ignored.</dd>
- <dt><em>baseURLstring </em>{{optional_inline}}</dt>
- <dd>Is a {{domxref("DOMString")}} representing the base URL to use in case <em>urlString</em> is a relative URL. If not specified, and no <em>baseURLobject</em> is passed in parameters, it default to <code>'about:blank'</code>. If it is an invalid absolute URL, the constructor will raise a {{domxref("DOMException")}} of type <code>SYNTAX_ERROR</code></dd>
- <dt><em>baseURLobject</em></dt>
- <dd>Is a {{domxref("URL")}} object representing the base URL to use in case <em>urlString</em> is a relative URL.</dd>
-</dl>
-
-<h2 id="Примеры">Примеры</h2>
-
-<pre class="brush: js  language-js">var a = new URL("/", "https://developer.mozilla.org"); // Creates a URL pointing to 'https://developer.mozilla.org/'
-var b = new URL("https://developer.mozilla.org");      // Creates a URL pointing to 'https://developer.mozilla.org/'
-var c = new URL('en-US/docs', b);                      // Creates a URL pointing to 'https://developer.mozilla.org/en-US/docs'
-var d = new URL('/en-US/docs', b);                     // Creates a URL pointing to 'https://developer.mozilla.org/en-US/docs'
-var f = new URL('/en-US/docs', d);                     // Creates a URL pointing to 'https://developer.mozilla.org/en-US/docs'
-var g = new URL('/en-US/docs', "https://developer.mozilla.org/fr-FR/toto");
-                                                       // Creates a URL pointing to 'https://developer.mozilla.org/en-US/docs'
-var h = new URL('/en-US/docs', a);                     // Creates a URL pointing to 'https://developer.mozilla.org/en-US/docs'
-var i = new URL('/en-US/docs', '');                    // Raises a SYNTAX ERROR exception as '/en-US/docs' is not valid
-var j = new URL('/en-US/docs');                        // Raises a SYNTAX ERROR exception as 'about:blank/en-US/docs' is not valid
-var k = new URL('http://www.example.com', 'https://developers.mozilla.com');
-                                                       // Creates a URL pointing to 'http://www.example.com/'
-var l = new URL('http://www.example.com', b);          // Creates a URL pointing to 'http://www.example.com/'
-</pre>
-
-<h2 id="Specification" name="Specification">Спецификация</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('URL', '#constructors', 'URL.URL()')}}</td>
-   <td>{{Spec2('URL')}}</td>
-   <td>Initial definition.</td>
-  </tr>
- </tbody>
-</table>
-
-<h2 id="Поддержка_браузерами">Поддержка браузерами</h2>
-
-<p>{{Compat("api.URL.URL")}}</p>
-
-<h2 id="Смотрите_также">Смотрите также</h2>
-
-<ul>
- <li>The interface it belongs to: {{domxref("URL")}}.</li>
-</ul>
-
-<p> </p>
diff --git a/files/ru/web/api/url/url/index.md b/files/ru/web/api/url/url/index.md
new file mode 100644
index 0000000000..8deeb1eed8
--- /dev/null
+++ b/files/ru/web/api/url/url/index.md
@@ -0,0 +1,81 @@
+---
+title: URL()
+slug: Web/API/URL/URL
+tags:
+  - API
+  - Constructor
+  - Reference
+  - URL
+  - URL API
+translation_of: Web/API/URL/URL
+---
+{{APIRef("URL API")}}
+
+Конструктор **`URL()`** возвращает вновь созданный  {{domxref("URL")}} объект, отражающий URL, определяемый параметрами.
+
+Если предоставленный базовый URL-адрес или итоговый URL-адрес не является валидным, то будет сгенерировано JavaScript исключение {{jsxref("TypeError")}}.
+
+{{AvailableInWorkers}}
+
+## Синтаксис
+
+```js
+const url = new URL(url [, base])
+```
+
+### Параметры
+
+- `url`
+ - : Строка типа {{domxref("USVString")}} или любой объект, который может быть [преобразован в строку](/en-US/docs/MDN/Contribute/Howto/Write_an_API_reference/Information_contained_in_a_WebIDL_file#stringifiers), включая, например, элементы {{htmlelement("a")}} и {{htmlelement("area")}}, представляющие абсолютный и относительный URL-адрес соответственно. Если `url` это относительный URL-адрес, то параметр `base` становится обязательным, так как он будет использован в качестве базового URL-адреса. Если же `url` — абсолютный URL-адрес, то значение параметра `base` будет проигнорировано.
+- `base` {{optional_inline}}
+ - : Строка типа {{domxref("USVString")}}. Используется в качестве базового адреса, когда `url` это относительный URL-адрес. Значение по умолчанию: `undefined`.
+
+> **Примечание:** Как и в случае с любым другим Web API, 
+> которое принимает на вход строку типа {{domxref("USVString")}}, 
+> аргументы <code>url</code> и <code>base</code> будут преобразованы в строку 
+> независимо от исходного типа переданного значения.
+> В частности, вы можете использовать существующий {{domxref("URL")}} объект в качестве аргумента 
+> и он будет преобразован в строку значение которой равно значению свойства 
+> {{domxref("URL.href", "href")}} переданного объекта.
+
+### Исключения
+
+| Исключение                       | Объяснение                                                                                                |
+| -------------------------------- | --------------------------------------------------------------------------------------------------------- |
+| {{jsxref("TypeError")}} | `url` (в случае с абсолютным URL-адресом) или `base` + `url` (в случае с относительным URL-адресом) является невалидным URL-адресом. |
+
+## Примеры
+
+```js
+// Базовые URL-адреса
+let m = 'https://developer.mozilla.org';
+let a = new URL("/", m);                                // => 'https://developer.mozilla.org/'
+let b = new URL(m);                                     // => 'https://developer.mozilla.org/'
+
+        new URL('en-US/docs', b);                      // => 'https://developer.mozilla.org/en-US/docs'
+let d = new URL('/en-US/docs', b);                     // => 'https://developer.mozilla.org/en-US/docs'
+        new URL('/en-US/docs', d);                     // => 'https://developer.mozilla.org/en-US/docs'
+        new URL('/en-US/docs', a);                     // => 'https://developer.mozilla.org/en-US/docs'
+
+        new URL('/en-US/docs', "https://developer.mozilla.org/fr-FR/toto");
+                                                        // => 'https://developer.mozilla.org/en-US/docs'
+
+        new URL('/en-US/docs', '');                    // Генерирует TypeError исключение так как '' не является валидным URL-адресом
+        new URL('/en-US/docs');                        // Генерирует TypeError исключение так как '/en-US/docs' не является валидным URL-адресом
+        new URL('http://www.example.com', );           // => 'http://www.example.com/'
+        new URL('http://www.example.com', b);          // => 'http://www.example.com/'
+
+        new URL("//foo.com", "https://example.com")    // => 'https://foo.com' (см. относительные URL-адреса)
+```
+
+## Спецификации
+
+{{Specifications}}
+
+## Поддержка браузерами
+
+{{Compat}}
+
+## Смотрите также
+- Полифил для `URL` доступен в [core-js](https://github.com/zloirock/core-js#url-and-urlsearchparams)
+- Этот интерфейс принадлежит: {{domxref("URL")}}.