diff options
Diffstat (limited to 'files/ru/web/api/url')
| -rw-r--r-- | files/ru/web/api/url/url/index.html | 75 | ||||
| -rw-r--r-- | files/ru/web/api/url/url/index.md | 81 |
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")}}. |