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

URL API

· 52CE 我爱测

URL API 是 URL 标准的一个组件,定义了有效 URL 的构成,以及访问和操作 URL 的 API。URL 标准还定义了像域名、主机和 IP 地址等概念,并尝试以标准的方式去描述用于以键/值对的形式提交 Web 表单内容的遗留 `application/x-www-form-urlencoded` MIME type 。

URL API

URL API 是 URL 标准的一个组件,定义了有效 URL 的构成,以及访问和操作 URL 的 API。URL 标准还定义了像域名、主机和 IP 地址等概念,并尝试以标准的方式去描述用于以键/值对的形式提交 Web 表单内容的遗留 application/x-www-form-urlencoded MIME type 。

概念和用法

URL 标准的主要内容是由 URL 的定义及其结构和解析方式决定的。还介绍了与网络上计算机寻址有关的各种术语的定义,并指定了解析 IP 地址和 DOM 地址的算法。大多数开发者更感兴趣于 API 本身。

使用 URL 组件

给指定的 URL 创建一个 URL 对象将解析该 URL,并通过其属性提供对其组成部分的快速访问。

let addr = new URL("https://developer.mozilla.org/zh-CN/docs/Web/API/URL_API");
let host = addr.host;
let path = addr.pathname;

上面的代码片段为你正在阅读的这篇文章创建一个 URL 对象,然后获取 URL.host 和 URL.pathname 属性。在本例中,这些字符串的值分别是 developer.mozilla.org 和 /zh-CN/docs/Web/API/URL_API。

修改 URL

URL 对象的大部分属性都是可设置的;你可以向它们写入新值来更改对象所表示的 URL。例如,要创建一个 URL 对象并设置它的用户名:

let myUsername = "someguy";
let addr = new URL("https://example.com/login");
addr.username = myUsername;

对 URL.username 的值的修改除了对属性值的变更,还更新整个 URL。执行上面的代码片段后,URL.href 的返回值是https://someguy@example.com/login。这一点对于任何可修改属性都是如此。

查询

URL 的 URL.search 属性包含 URL 的查询字符串部分。例如,如果 URL 是 https://example.com/login?user=someguy&page=news,那么 search 属性的值是 ?user=someguy&page=news。你还可以使用 URLSearchParams 对象的 URLSearchParams.get 查找单个参数的值:

let addr = new URL("https://example.com/login?user=someguy&page=news");
try {
  loginUser(addr.searchParams.get("user"));
  gotoPage(addr.searchParams.get("page"));
} catch (err) {
  showErrorMessage(err);
}

例如,在上面的代码片段中,从查询中提取用户名和目标页面,并将其传递给适当的函数,站点代码使用这些函数登录并将用户路由到站点的目的页面。

URLSearchParams 中的其他函数允许修改、添加和删除键和值,甚至对参数列表进行排序。

接口

URL API 是一个简单的 API,它的名字只有几个接口:

  • URL
    • : 可被用于解析、构建、标准化和编码 URL。
  • URLSearchParams
    • : 定义各种用于处理 URL 的查询字符串的实用方法。

示例

如果希望处理 URL 中包含的参数,可以手动进行处理,但是创建一个 URL 对象更容易。下面的 fillTableWithParameters() 函数接受一个表示 table 的 HTMLTableElement 对象作为输入。将行添加到表中,一行对应参数中找到的一个键,第一列包含键,第二列包含值。

注意,在生成表之前调用 URLSearchParams.sort() 对参数列表进行排序。

function fillTableWithParameters(tbl) {
  let url = new URL(document.location.href);
  url.searchParams.sort();
  let keys = url.searchParams.keys();

  for (let key of keys) {
    let val = url.searchParams.get(key);
    let row = document.createElement("tr");
    let cell = document.createElement("td");
    cell.innerText = key;
    row.appendChild(cell);
    cell = document.createElement("td");
    cell.innerText = val;
    row.appendChild(cell);
    tbl.appendChild(row);
  }
}

可在 Glitch 上找到该示例的可用版本。只要在加载页面时向 URL 添加参数,就可以在表中看到它们。例如,试试 https://url-api.glitch.me?from=mdn&excitement=high&likelihood=inconceivable。

规范

浏览器兼容性

参见

  • Fetch API
  • CSS <url> 类型
  • encodeURI
  • encodeURIComponent

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

资料来源与适用范围

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

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

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