URL

Этот перевод не завершён. Пожалуйста, помогите перевести эту статью с английского

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

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
КомпьютерыМобильные
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung Internet
URLChrome Полная поддержка 32
Полная поддержка 32
Полная поддержка 19
С префиксом
С префиксом Требует вендорный префикс: webkit
Edge Полная поддержка 12Firefox Полная поддержка 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 Полная поддержка 10Opera Полная поддержка 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() constructorChrome Полная поддержка 19Edge Полная поддержка 12Firefox Полная поддержка 26IE Нет поддержки НетOpera Полная поддержка 15Safari Полная поддержка 6WebView Android Полная поддержка ≤37Chrome Android Полная поддержка 25Firefox Android Полная поддержка 26Opera Android Полная поддержка 14Safari iOS Полная поддержка 6Samsung Internet Android Полная поддержка 1.5
createObjectURL
Экспериментальная
Chrome Полная поддержка 19Edge Полная поддержка 12Firefox Полная поддержка 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 Полная поддержка 15Safari Полная поддержка 6WebView Android Полная поддержка ДаChrome Android Полная поддержка 25Firefox Android Полная поддержка 19
Замечания
Полная поддержка 19
Замечания
Замечания createObjectURL() is no longer available within the context of a ServiceWorker.
Opera Android Полная поддержка 14Safari iOS Полная поддержка 6Samsung Internet Android Полная поддержка 1.5
hashChrome Полная поддержка ДаEdge Полная поддержка 13Firefox Полная поддержка 22IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 22Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
hostChrome Полная поддержка ДаEdge Полная поддержка 13Firefox Полная поддержка 22IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 22Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
hostnameChrome Полная поддержка ДаEdge Полная поддержка 13Firefox Полная поддержка 22IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка 10WebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 22Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
hrefChrome Полная поддержка ДаEdge Полная поддержка 13Firefox Полная поддержка 22IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка 10WebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 22Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
originChrome Полная поддержка 32Edge Полная поддержка 12Firefox Полная поддержка 26
Полная поддержка 26
Нет поддержки 26 — 49
Замечания
Замечания Results for URL using the blob scheme incorrectly returned null.
IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка 10WebView Android Полная поддержка ≤37Chrome Android Полная поддержка 32Firefox Android Полная поддержка 26
Полная поддержка 26
Нет поддержки 26 — 49
Замечания
Замечания Results for URL using the blob scheme incorrectly returned null.
Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 6.0
passwordChrome Полная поддержка 32Edge Полная поддержка 12Firefox Полная поддержка 26IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка 10WebView Android Полная поддержка ≤37Chrome Android Полная поддержка 32Firefox Android Полная поддержка 26Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 6.0
pathnameChrome Полная поддержка ДаEdge Полная поддержка 13Firefox Полная поддержка 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 Полная поддержка 10WebView 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 Полная поддержка Да
portChrome Полная поддержка ДаEdge Полная поддержка 13Firefox Полная поддержка 22IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка 10WebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 22Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
protocolChrome Полная поддержка ДаEdge Полная поддержка 13Firefox Полная поддержка 22IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка 10WebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 22Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
revokeObjectURL
Экспериментальная
Chrome Полная поддержка 19Edge Полная поддержка 12Firefox Полная поддержка 19
Замечания
Полная поддержка 19
Замечания
Замечания revokeObjectURL() is no longer available within the context of a ServiceWorker.
IE Полная поддержка 10Opera Полная поддержка 15Safari Полная поддержка 6WebView Android Полная поддержка ≤37Chrome Android Полная поддержка 25Firefox Android Полная поддержка 19
Замечания
Полная поддержка 19
Замечания
Замечания revokeObjectURL() is no longer available within the context of a ServiceWorker.
Opera Android Полная поддержка 14Safari iOS Полная поддержка 6Samsung Internet Android Полная поддержка 1.5
searchChrome Полная поддержка ДаEdge Полная поддержка 13Firefox Полная поддержка 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 Полная поддержка 10WebView 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 Полная поддержка Да
searchParamsChrome Полная поддержка 51Edge Полная поддержка 17Firefox Полная поддержка 29IE Нет поддержки НетOpera Полная поддержка 38Safari Полная поддержка 10WebView Android Полная поддержка 51Chrome Android Полная поддержка 51Firefox Android Полная поддержка 29Opera Android Полная поддержка 41Safari iOS Полная поддержка 10Samsung Internet Android Полная поддержка 5.0
toJSONChrome Полная поддержка 71Edge Полная поддержка 17Firefox Полная поддержка 54IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка 71Chrome Android Полная поддержка 71Firefox Android Полная поддержка 54Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 10.0
toStringChrome Полная поддержка 19Edge Полная поддержка 17Firefox Полная поддержка 54IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ≤37Chrome Android Полная поддержка 25Firefox Android Полная поддержка 54Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 6.0
usernameChrome Полная поддержка 32Edge Полная поддержка 12Firefox Полная поддержка 26IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка 10WebView Android Полная поддержка ≤37Chrome Android Полная поддержка 32Firefox Android Полная поддержка 26Opera 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.

См. также