URL API
URL() 构造函数返回一个新创建的 URL 对象,该对象表示由参数定义的 URL。
如果给定的基本 URL 或生成的 URL 不是有效的 URL,则会抛出 JavaScript TypeError 异常。
语法
new URL(url)
new URL(url, base)
参数
url- : 一个表示绝对或相对 URL 的 String 或任何具有字符串化方法的对象,例如 a 或 area 元素。如果
url是相对 URL,则会将base用作基准 URL。如果url是绝对 URL,则无论参数base是否存在,都将被忽略。
- : 一个表示绝对或相对 URL 的 String 或任何具有字符串化方法的对象,例如 a 或 area 元素。如果
base- : 一个表示基准 URL 的字符串,当
url为相对 URL 时,它才会生效。如果未指定,它默认为undefined。
- : 一个表示基准 URL 的字符串,当
[!NOTE]
url和base参数将从任意对象转换为字符串,就像其他接受字符串的 Web API 一样。特别地,你可以为任一参数使用现有的 URL 对象,它将被转换为该对象的 URL.href 属性。
异常
| 异常 | 解释 |
|---|---|
| TypeError | url(若为绝对 URL)或 base + url(若为相对 URL)是一个无效的 URL 链接。 |
示例
// 基准 URL:
let baseUrl = "https://developer.mozilla.org";
let A = new URL("/", baseUrl);
// => 'https://developer.mozilla.org/'
let B = new URL(baseUrl);
// => 'https://developer.mozilla.org/'
new URL("en-US/docs", B);
// => 'https://developer.mozilla.org/en-US/docs'
let D = new URL("/en-US/docs", B);
// => 'https://developer.mozilla.org/en-US/docs'
new URL("/en-US/docs", D);
// => 'https://developer.mozilla.org/en-US/docs'
new URL("/en-US/docs", A);
// => 'https://developer.mozilla.org/en-US/docs'
new URL("/en-US/docs", "https://developer.mozilla.org/fr-FR/toto");
// => 'https://developer.mozilla.org/en-US/docs'
// 无效 URL:
new URL("/en-US/docs", "");
// 抛出 TypeError 异常:'' is not a valid URL
new URL("/en-US/docs");
// 抛出 TypeError 异常:'/en-US/docs' is not a valid URL
// 其他示例:
new URL("http://www.example.com");
// => 'http://www.example.com/'
new URL("http://www.example.com", B);
// => 'http://www.example.com/'
new URL("", "https://example.com/?query=1");
// => 'https://example.com/?query=1'(Edge 早于 79 的版本会移除查询参数)
new URL("/a", "https://example.com/?query=1");
// => 'https://example.com/a'(见相对 URL)
new URL("//foo.com", "https://example.com");
// => 'https://foo.com/'(见相对 URL)
规范
浏览器兼容性
参见
core-js中URL的 polyfill- 接口:URL
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
