大网数据广告活动
Web 标准与前端开发

URL

· 52CE 我爱测

`URL`** 接口用于解析,构造,规范化和编码 URL。它通过提供允许你轻松阅读和修改 URL 组件的属性来工作。通常,通过在调用 URL 的构造函数时将 URL 指定为字符串或提供相对 URL 和基本 URL 来创建新的 URL 对象。然后,你可以轻松读取 URL 的已解析组成部分或对 URL 进行更改。

URL API

URL 接口用于解析,构造,规范化和编码 URL。它通过提供允许你轻松阅读和修改 URL 组件的属性来工作。通常,通过在调用 URL 的构造函数时将 URL 指定为字符串或提供相对 URL 和基本 URL 来创建新的 URL 对象。然后,你可以轻松读取 URL 的已解析组成部分或对 URL 进行更改。

如果浏览器尚不支持URL.URL构造函数,则可以使用Window中的Window.URL属性。确保检查你的任何目标浏览器是否要求对此添加前缀。

构造器

  • URL.URL
    • : 创建并返回一个URL对象,该 URL 对象引用使用绝对 URL 字符串,相对 URL 字符串和基本 URL 字符串指定的 URL。

属性

  • URL.hash
    • : 包含'#'的String,后跟 URL 的片段标识符。
  • URL.host
    • : 一个String,其中包含域(即主机名),后跟(如果指定了端口)“:”和 URL 的端口。
  • URL.hostname
    • : 包含 URL 域名的 String。
  • URL.href
    • : 包含完整 URL 的 String。
  • URL.origin
    • : 返回一个包含协议名、域名和端口号的 String。
  • URL.password
    • : 包含在域名前面指定的密码的 String 。
  • URL.pathname
    • : 以 '/' 起头紧跟着 URL 文件路径的 String。
  • URL.port
    • : 包含 URL 端口号的 String。
  • URL.protocol
    • : 包含 URL 协议名的 String,末尾带 ':'。
  • URL.search
    • : 一个String ,指示 URL 的参数字符串;如果提供了任何参数,则此字符串包括所有参数,并以开头的“?”开头 字符。
  • URL.searchParams
    • : URLSearchParams对象,可用于访问search中找到的各个查询参数。
  • URL.username
    • : 包含在域名前面指定的用户名的 String。

方法

  • URL.toString
    • : 返回包含整个 URL 的String。它是URL.href的同义词,尽管它不能用于修改值。
  • URL.toJSON
    • : 返回包含整个 URL 的String。它返回与href属性相同的字符串。

静态方法

  • URL.createObjectURL
    • : 返回一个String ,包含一个唯一的 blob 链接(该链接协议为以 blob:,后跟唯一标识浏览器中的对象的掩码)。
  • URL.revokeObjectURL
    • : 销毁之前使用URL.createObjectURL()方法创建的 URL 实例。

使用说明

如果url参数是相对 URL,则构造函数将使用url参数和可选的base参数作为基础。

const url = new URL("../cats", "http://www.example.com/dogs");
console.log(url.hostname); // "www.example.com"
console.log(url.pathname); // "/cats"

可以设置 URL 属性以构造 URL:

url.hash = "tabby";
console.log(url.href); // "http://www.example.com/cats#tabby"

URL 根据 中的规则进行编码。例如:

url.pathname = "démonstration.html";
console.log(url.href); // "http://www.example.com/d%C3%A9monstration.html"

URLSearchParams接口可用于构建和处理 URL 查询字符串。

要从当前窗口的 URL 获取搜索参数,可以执行以下操作:

// https://some.site/?id=123
const parsedUrl = new URL(window.location.href);
console.log(parsedUrl.searchParams.get("id")); // "123"

URL 的URL.toString方法仅返回URL.href 属性的值,因此构造函数可以 用于直接对 URL 进行规范化和编码。

const response = await fetch(
  new URL("http://www.example.com/démonstration.html"),
);

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。