URL()

URL() 构造函数返回一个新创建的URL对象，表示由参数定义的URL。

如果给定的基本URL或生成的URL不是有效的URL，则会抛出一个类型为SYNTAX_ERROR的DOMException。

语法

const url = new URL(urlString, [baseURLstring])
const url = new URL(urlString, baseURLobject)

参数

urlString

是一个表示绝对或相对URL的DOMString。如果urlString是相对URL，则baseURLstring或baseURLobject（无论存在）都将用作基本URL。如果urlString是绝对URL，则将忽略baseURLstring和baseURLobject。

baseURLstring 可选

是一个表示基本URL的DOMString，以便在urlString是相对URL时使用。如果未指定，且在参数中未传递baseURLobject，则默认为“about：blank”。如果它是一个无效的绝对URL，构造函数将引发一个类型为SYNTAX_ERROR的DOMException

baseURLobject

是表示基本URL的URL 对象，以便在urlString是相对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 SYNTAX ERROR exception as '/en-US/docs' is not valid
var j = new URL('/en-US/docs');                        // Raises a SYNTAX ERROR exception as 'about:blank/en-US/docs' is not valid
var k = new URL('http://www.example.com', 'https://developers.mozilla.com');
                                                       // Creates a URL pointing to 'https://www.example.com'
var l = new URL('http://www.example.com', b);          // Creates a URL pointing to 'https://www.example.com'

Specification

Browser compatibility

See also

• The interface it belongs to: URL.