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. - 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 | Edge | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | (Yes) | 26.0 (26.0) | No support | 12 | (Yes) | (Yes) |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | 4.4.4 | 26.0 (26.0) | No support | ? | (Yes) |
See also
- The interface it belongs to:
URL
.
Document Tags and Contributors
Tags:
Contributors to this page:
GuilloOme,
DevelX,
chrisdavidmills,
gonchuki,
hsource,
onlywei,
yan,
graingert,
teoli,
afreen,
realityking,
Bountin,
mattbrundage,
vishu_gawli
Last updated by:
GuilloOme,