This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
The URL()
constructor returns a newly created URL
object representing the URL defined by the parameters.
If the given base URL or the resulting URL are not valid URLs, a DOMException
of type SYNTAX_ERROR
is thrown.
Note: This feature is available in Web Workers.
Syntax
url = new URL(url, [base])
Parameters
- url
- A
USVString
representing an absolute or relative URL. If url is a relative URL, base is required, and will be used as the base URL. If url is an absolute URL, a given base will be ignored. If - base Optional
- A
USVString
representing the base URL to use in case url is a relative URL. If not specified, it defaults to''
.
Note: You can still use an existing URL
object for the base, which stringifies itself to the object's href
attribute.
Exceptions
Exception | Explanation |
---|---|
TypeError |
url (in the case of absolute URLs) or base + url (in the case of relative URLs) is not a valid URL. |
Example
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 TypeError exception as '' is not a valid URL var j = new URL('/en-US/docs'); // Raises a TypeError exception as '/en-US/docs' is not a valid URL 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/'
Specification
Specification | Status | Comment |
---|---|---|
URL The definition of 'URL.URL()' in that specification. |
Living Standard | Initial definition. |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes) | 26.0 (26.0) | No support | (Yes) | (Yes) |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | ? | 26.0 (26.0) | No support | ? | (Yes) |
See also
- The interface it belongs to:
URL
.
Document Tags and Contributors
Tags:
Contributors to this page:
chrisdavidmills,
gonchuki,
hsource,
onlywei,
yan,
graingert,
teoli,
afreen,
realityking,
Bountin,
mattbrundage,
vishu_gawli
Last updated by:
chrisdavidmills,