URL API 参考

URL API 用于解析、构造、规范化和修改 URL。相比手写字符串拆分，new URL() 更适合处理协议、域名、路径、查询参数和 hash。

语法

const url = new URL(input, base);

参数

• input：完整 URL 或相对路径。
• base：可选，解析相对路径时使用的基础 URL。

常用属性

示例

const url = new URL("/search?q=javascript&page=1", "https://caijiao.org");

url.searchParams.set("page", "2");
url.hash = "result";

console.log(url.href);
// https://caijiao.org/search?q=javascript&page=2#result

常见用法

• 从 location.href 中读取当前页面信息。
• 用 new URL(path, location.origin) 拼接站内地址。
• 通过 url.searchParams 安全读写查询参数。
• 配合 URL.createObjectURL(blob) 创建临时下载地址。

常见错误

• 直接 new URL("/path") 会报错，因为相对路径需要 base。
• 手写字符串拼接查询参数容易漏掉 URL 编码，应使用 URLSearchParams。
• 用 URL.createObjectURL() 创建 Blob URL 后，应在不再使用时调用 URL.revokeObjectURL()。

相关内容

• Web API Reference
• URLSearchParams
• Blob
• JavaScript 如何获取 URL 参数
• URL Encoder / Decoder
• MDN URL