URL

Experimental: Dies ist eine experimentelle Technologie
Da diese Technologie noch nicht definitiv implementiert wurde, sollte die Browserkompatibilität beachtet werden. Es ist auch möglich, dass die Syntax in einer späteren Spezifikation noch geändert wird.

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

Properties

Implements properties defined in URLUtils.

URLUtils.href
Is a DOMString (en-US) containing the whole URL.
URLUtils.protocol
Is a DOMString (en-US) containing the protocol scheme of the URL, including the final ':'.
URLUtils.host
Is a DOMString (en-US) containing the host, that is the hostname, a ':', and the port of the URL.
URLUtils.hostname
Is a DOMString (en-US) containing the domain of the URL.
URLUtils.port
Is a DOMString (en-US) containing the port number of the URL.
URLUtils.pathname
Is a DOMString (en-US) containing an initial '/' followed by the path of the URL.
URLUtils.search
Is a DOMString (en-US) containing a '?' followed by the parameters of the URL.
URLUtils.hash
Is a DOMString (en-US) containing a '#' followed by the fragment identifier of the URL.
URLUtils.username
Is a DOMString (en-US) containing the username specified before the domain name.
URLUtils.password
Is a DOMString (en-US) containing the password specified before the domain name.
URLUtils.origin Schreibgeschützt
Returns a DOMString (en-US) 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() (en-US)
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 (en-US) 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 (en-US) 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() (en-US)
Revokes an object URL previously created using URL.createObjectURL().

Specifications

Specification Status Comment
File API
Die Definition von 'URL' in dieser Spezifikation.
Arbeitsentwurf Added the static methods URL.createObjectURL() and URL.revokeObjectURL().
URL
Die Definition von 'Node' in dieser Spezifikation.
Lebender Standard Initial definition (implements URLUtils).

Browser compatibility

BCD tables only load in the browser

[1] From Gecko 2 (Firefox 4) to Gecko 18 included, Gecko supported this interface with the non-standard nsIDOMMozURLProperty internal type. As the only to access such an object was through window.URL (en-US), in practice, this didn't make any difference.

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.

See also