URL - Интерфейсы веб API

Это экспериментальная технология
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.

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 Window.URL properties (prefixed with Webkit-based browser as Window.webkitURL).

Примечание: Эта возможность доступна в Web Workers.

Properties

Implements properties defined in URLUtils.

URLUtils.href: Is a DOMString containing the whole URL.
URLUtils.protocol: Is a DOMString containing the protocol scheme of the URL, including the final ':'.
URLUtils.host: Is a DOMString containing the host, that is the hostname, a ':', and the port of the URL.
URLUtils.hostname: Is a DOMString containing the domain of the URL.
URLUtils.port: Is a DOMString containing the port number of the URL.
URLUtils.pathname: Is a DOMString containing an initial '/' followed by the path of the URL.
URLUtils.search: Is a DOMString containing a '?' followed by the parameters of the URL.
URLUtils.hash: Is a DOMString containing a '#' followed by the fragment identifier of the URL.
URLUtils.username: Is a DOMString containing the username specified before the domain name.
URLUtils.password: Is a DOMString containing the password specified before the domain name.
URLUtils.origin Только для чтения: Returns a DOMString containing the origin of the URL, that is its scheme, its domain and its port.

URLUtils.searchParams: Returns a URLSearchParams object allowing to access the GET query arguments contained in the URL.

Constructor

URL(): Creates and return a URL object composed from the given parameters.

Methods

The URL interface implements methods defined in URLUtils.

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

Static methods

URL.createObjectURL(): Returns a 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.
URL.revokeObjectURL(): Revokes an object URL previously created using URL.createObjectURL().

Specifications

Specification	Status	Comment
File API Определение 'URL' в этой спецификации.	Рабочий черновик	Added the static methods `URL.createObjectURL()` and `URL.revokeObjectURL()`.
URL Определение 'Node' в этой спецификации.	Живой стандарт	Initial definition (implements `URLUtils`).

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

Update compatibility data on GitHub

	Компьютеры						Мобильные
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome для Android	Firefox для Android	Opera для Android	Safari on iOS	Samsung Internet
`URL`	Chrome Полная поддержка 32 Полная поддержка 32 Полная поддержка 19 С префиксом С префиксом Требует вендорный префикс: webkit	Edge Полная поддержка 12	Firefox Полная поддержка 19 Замечания Полная поддержка 19 Замечания Замечания Before version 57, Firefox had a bug whereby single quotes contained in URLs are escaped when accessed via URL APIs (see bug 1386683). Замечания To use it from chrome code, JSM and Bootstrap scope, you have to import it with `Cu.importGlobalProperties(['URL']);`.	IE Полная поддержка 10	Opera Полная поддержка 19 Полная поддержка 19 Полная поддержка 15 С префиксом С префиксом Требует вендорный префикс: webkit	Safari Полная поддержка 7 Полная поддержка 7 Полная поддержка 6 С префиксом С префиксом Требует вендорный префикс: webkit	WebView Android Полная поддержка 4.4 Полная поддержка 4.4 Полная поддержка 4 С префиксом С префиксом Требует вендорный префикс: webkit	Chrome Android Полная поддержка 32 Полная поддержка 32 Полная поддержка 25 С префиксом С префиксом Требует вендорный префикс: webkit	Firefox Android Полная поддержка 19 Замечания Полная поддержка 19 Замечания Замечания Before version 57, Firefox had a bug whereby single quotes contained in URLs are escaped when accessed via URL APIs (see bug 1386683). Замечания To use it from chrome code, JSM and Bootstrap scope, you have to import it with `Cu.importGlobalProperties(['URL']);`.	Opera Android Полная поддержка 19 Полная поддержка 19 Полная поддержка 14 С префиксом С префиксом Требует вендорный префикс: webkit	Safari iOS Полная поддержка 7 Полная поддержка 7 Полная поддержка 6 С префиксом С префиксом Требует вендорный префикс: webkit	Samsung Internet Android Полная поддержка 2.0 Полная поддержка 2.0 Полная поддержка 1.5 С префиксом С префиксом Требует вендорный префикс: webkit
`URL()` constructor	Chrome Полная поддержка 19	Edge Полная поддержка 12	Firefox Полная поддержка 26	IE Нет поддержки Нет	Opera Полная поддержка 15	Safari Полная поддержка 6	WebView Android Полная поддержка ≤37	Chrome Android Полная поддержка 25	Firefox Android Полная поддержка 26	Opera Android Полная поддержка 14	Safari iOS Полная поддержка 6	Samsung Internet Android Полная поддержка 1.5
`createObjectURL` Экспериментальная	Chrome Полная поддержка 19	Edge Полная поддержка 12	Firefox Полная поддержка 19 Замечания Полная поддержка 19 Замечания Замечания `createObjectURL()` is no longer available within the context of a `ServiceWorker`.	IE Полная поддержка 10 Замечания Полная поддержка 10 Замечания Замечания If the underlying object does not have a content type set, using this URL as the `src` of an `img` tag fails intermittently with error DOM7009.	Opera Полная поддержка 15	Safari Полная поддержка 6	WebView Android Полная поддержка Да	Chrome Android Полная поддержка 25	Firefox Android Полная поддержка 19 Замечания Полная поддержка 19 Замечания Замечания `createObjectURL()` is no longer available within the context of a `ServiceWorker`.	Opera Android Полная поддержка 14	Safari iOS Полная поддержка 6	Samsung Internet Android Полная поддержка 1.5
`hash`	Chrome Полная поддержка Да	Edge Полная поддержка 13	Firefox Полная поддержка 22	IE Нет поддержки Нет	Opera Полная поддержка Да	Safari Полная поддержка Да	WebView Android Полная поддержка Да	Chrome Android Полная поддержка Да	Firefox Android Полная поддержка 22	Opera Android Полная поддержка Да	Safari iOS Полная поддержка Да	Samsung Internet Android Полная поддержка Да
`host`	Chrome Полная поддержка Да	Edge Полная поддержка 13	Firefox Полная поддержка 22	IE Нет поддержки Нет	Opera Полная поддержка Да	Safari Полная поддержка Да	WebView Android Полная поддержка Да	Chrome Android Полная поддержка Да	Firefox Android Полная поддержка 22	Opera Android Полная поддержка Да	Safari iOS Полная поддержка Да	Samsung Internet Android Полная поддержка Да
`hostname`	Chrome Полная поддержка Да	Edge Полная поддержка 13	Firefox Полная поддержка 22	IE Нет поддержки Нет	Opera Полная поддержка Да	Safari Полная поддержка 10	WebView Android Полная поддержка Да	Chrome Android Полная поддержка Да	Firefox Android Полная поддержка 22	Opera Android Полная поддержка Да	Safari iOS Полная поддержка Да	Samsung Internet Android Полная поддержка Да
`href`	Chrome Полная поддержка Да	Edge Полная поддержка 13	Firefox Полная поддержка 22	IE Нет поддержки Нет	Opera Полная поддержка Да	Safari Полная поддержка 10	WebView Android Полная поддержка Да	Chrome Android Полная поддержка Да	Firefox Android Полная поддержка 22	Opera Android Полная поддержка Да	Safari iOS Полная поддержка Да	Samsung Internet Android Полная поддержка Да
`origin`	Chrome Полная поддержка 32	Edge Полная поддержка 12	Firefox Полная поддержка 26 Полная поддержка 26 Нет поддержки 26 — 49 Замечания Замечания Results for `URL` using the `blob` scheme incorrectly returned `null`.	IE Нет поддержки Нет	Opera Полная поддержка Да	Safari Полная поддержка 10	WebView Android Полная поддержка ≤37	Chrome Android Полная поддержка 32	Firefox Android Полная поддержка 26 Полная поддержка 26 Нет поддержки 26 — 49 Замечания Замечания Results for `URL` using the `blob` scheme incorrectly returned `null`.	Opera Android Полная поддержка Да	Safari iOS Полная поддержка Да	Samsung Internet Android Полная поддержка 6.0
`password`	Chrome Полная поддержка 32	Edge Полная поддержка 12	Firefox Полная поддержка 26	IE Нет поддержки Нет	Opera Полная поддержка Да	Safari Полная поддержка 10	WebView Android Полная поддержка ≤37	Chrome Android Полная поддержка 32	Firefox Android Полная поддержка 26	Opera Android Полная поддержка Да	Safari iOS Полная поддержка Да	Samsung Internet Android Полная поддержка 6.0
`pathname`	Chrome Полная поддержка Да	Edge Полная поддержка 13	Firefox Полная поддержка 53 Полная поддержка 53 Нет поддержки 22 — 53 Замечания Замечания `pathname` and `search` returned the wrong values so that for a URL of `http://z.com/x?a=true&b=false`, `pathname` would return "/x?a=true&b=false" and `search` would return "", rather than "/x" and "?a=true&b=false" respectively.	IE Нет поддержки Нет	Opera Полная поддержка Да	Safari Полная поддержка 10	WebView Android Полная поддержка Да	Chrome Android Полная поддержка Да	Firefox Android Полная поддержка 53 Полная поддержка 53 Нет поддержки 22 — 53 Замечания Замечания `pathname` and `search` returned the wrong values so that for a URL of `http://z.com/x?a=true&b=false`, `pathname` would return "/x?a=true&b=false" and `search` would return "", rather than "/x" and "?a=true&b=false" respectively.	Opera Android Полная поддержка Да	Safari iOS Полная поддержка Да	Samsung Internet Android Полная поддержка Да
`port`	Chrome Полная поддержка Да	Edge Полная поддержка 13	Firefox Полная поддержка 22	IE Нет поддержки Нет	Opera Полная поддержка Да	Safari Полная поддержка 10	WebView Android Полная поддержка Да	Chrome Android Полная поддержка Да	Firefox Android Полная поддержка 22	Opera Android Полная поддержка Да	Safari iOS Полная поддержка Да	Samsung Internet Android Полная поддержка Да
`protocol`	Chrome Полная поддержка Да	Edge Полная поддержка 13	Firefox Полная поддержка 22	IE Нет поддержки Нет	Opera Полная поддержка Да	Safari Полная поддержка 10	WebView Android Полная поддержка Да	Chrome Android Полная поддержка Да	Firefox Android Полная поддержка 22	Opera Android Полная поддержка Да	Safari iOS Полная поддержка Да	Samsung Internet Android Полная поддержка Да
`revokeObjectURL` Экспериментальная	Chrome Полная поддержка 19	Edge Полная поддержка 12	Firefox Полная поддержка 19 Замечания Полная поддержка 19 Замечания Замечания `revokeObjectURL()` is no longer available within the context of a `ServiceWorker`.	IE Полная поддержка 10	Opera Полная поддержка 15	Safari Полная поддержка 6	WebView Android Полная поддержка ≤37	Chrome Android Полная поддержка 25	Firefox Android Полная поддержка 19 Замечания Полная поддержка 19 Замечания Замечания `revokeObjectURL()` is no longer available within the context of a `ServiceWorker`.	Opera Android Полная поддержка 14	Safari iOS Полная поддержка 6	Samsung Internet Android Полная поддержка 1.5
`search`	Chrome Полная поддержка Да	Edge Полная поддержка 13	Firefox Полная поддержка 53 Полная поддержка 53 Нет поддержки 22 — 53 Замечания Замечания `pathname` and `search` returned the wrong values so that for a URL of `http://z.com/x?a=true&b=false`, `pathname` would return "/x?a=true&b=false" and `search` would return "", rather than "/x" and "?a=true&b=false" respectively.	IE Нет поддержки Нет	Opera Полная поддержка Да	Safari Полная поддержка 10	WebView Android Полная поддержка Да	Chrome Android Полная поддержка Да	Firefox Android Полная поддержка 53 Полная поддержка 53 Нет поддержки 22 — 53 Замечания Замечания `pathname` and `search` returned the wrong values so that for a URL of `http://z.com/x?a=true&b=false`, `pathname` would return "/x?a=true&b=false" and `search` would return "", rather than "/x" and "?a=true&b=false" respectively.	Opera Android Полная поддержка Да	Safari iOS Полная поддержка Да	Samsung Internet Android Полная поддержка Да
`searchParams`	Chrome Полная поддержка 51	Edge Полная поддержка 17	Firefox Полная поддержка 29	IE Нет поддержки Нет	Opera Полная поддержка 38	Safari Полная поддержка 10	WebView Android Полная поддержка 51	Chrome Android Полная поддержка 51	Firefox Android Полная поддержка 29	Opera Android Полная поддержка 41	Safari iOS Полная поддержка 10	Samsung Internet Android Полная поддержка 5.0
`toJSON`	Chrome Полная поддержка 71	Edge Полная поддержка 17	Firefox Полная поддержка 54	IE Нет поддержки Нет	Opera Полная поддержка Да	Safari Полная поддержка Да	WebView Android Полная поддержка 71	Chrome Android Полная поддержка 71	Firefox Android Полная поддержка 54	Opera Android Полная поддержка Да	Safari iOS Полная поддержка Да	Samsung Internet Android Полная поддержка 10.0
`toString`	Chrome Полная поддержка 19	Edge Полная поддержка 17	Firefox Полная поддержка 54	IE Нет поддержки Нет	Opera Полная поддержка Да	Safari Полная поддержка Да	WebView Android Полная поддержка ≤37	Chrome Android Полная поддержка 25	Firefox Android Полная поддержка 54	Opera Android Полная поддержка Да	Safari iOS Полная поддержка Да	Samsung Internet Android Полная поддержка 6.0
`username`	Chrome Полная поддержка 32	Edge Полная поддержка 12	Firefox Полная поддержка 26	IE Нет поддержки Нет	Opera Полная поддержка Да	Safari Полная поддержка 10	WebView Android Полная поддержка ≤37	Chrome Android Полная поддержка 32	Firefox Android Полная поддержка 26	Opera Android Полная поддержка Да	Safari iOS Полная поддержка Да	Samsung Internet Android Полная поддержка 6.0

Легенда

Полная поддержка: Полная поддержка
Нет поддержки: Нет поддержки
Экспериментальная. Ожидаемое поведение может измениться в будущем.: Экспериментальная. Ожидаемое поведение может измениться в будущем.
Смотрите замечания реализации.: Смотрите замечания реализации.
Требует вендорный префикс или другое имя для использования.: Требует вендорный префикс или другое имя для использования.

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.

См. также

Property allowing to get such an object: Window.URL.
Components.utils.importGlobalProperties