From 2e2d0467ea0b59ec09aa1507a8d41c47d7e1ed30 Mon Sep 17 00:00:00 2001 From: Dima Koltovych Date: Sun, 26 Sep 2021 15:09:33 +0300 Subject: (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> --- files/ru/web/api/url/url/index.html | 75 ---------------------------------- files/ru/web/api/url/url/index.md | 81 +++++++++++++++++++++++++++++++++++++ 2 files changed, 81 insertions(+), 75 deletions(-) delete mode 100644 files/ru/web/api/url/url/index.html create mode 100644 files/ru/web/api/url/url/index.md (limited to 'files/ru/web') 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 ---- -

{{SeeCompatTable}}{{APIRef("URL API")}}

- -

Конструктор URL() возвращает вновь созданный  {{domxref("URL")}} объект отражающий URL определяемый параметрами.

- -

If the given base URL or the resulting URL are not valid URLs, a {{domxref("DOMException")}} of type SYNTAX_ERROR is thrown.

- -

{{AvailableInWorkers}}

- -

Синтаксис

- -
url = new URL(urlString, [baseURLstring])
-url = new URL(urlString, baseURLobject)
-
- -

Параметры

- -
-
urlString
-
Is a {{domxref("DOMString")}} representing an absolute or relative URL. If urlString is a relative URL, baseURLstring or baseURLobject, whichever is present, will be used as the base URL. If urlString is an absolute URL, baseURLstring and baseURLobject are ignored.
-
baseURLstring {{optional_inline}}
-
Is a {{domxref("DOMString")}} representing the base URL to use in case urlString is a relative URL. If not specified, and no baseURLobject is passed in parameters, it default to 'about:blank'. If it is an invalid absolute URL, the constructor will raise a {{domxref("DOMException")}} of type SYNTAX_ERROR
-
baseURLobject
-
Is a {{domxref("URL")}} object representing the base URL to use in case urlString is a relative URL.
-
- -

Примеры

- -
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/'
-
- -

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

- - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('URL', '#constructors', 'URL.URL()')}}{{Spec2('URL')}}Initial definition.
- -

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

- -

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

- -

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

- - - -

 

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")}}, +> аргументы url и base будут преобразованы в строку +> независимо от исходного типа переданного значения. +> В частности, вы можете использовать существующий {{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")}}. -- cgit v1.2.3-54-g00ecf