URL 和 URLSearchParams 是 JavaScript 处理 URL 的原生 API:URL 对象结构化解析/构造 URL 并自动同步更新,URLSearchParams 专用于安全增删改查查询参数并自动编码解码,二者组合可清晰可靠地操作 URL。

URL 和 URLSearchParams 是 JavaScript 中专门用于处理 URL 的原生 API,它们让解析、构建和操作 URL 变得直观、安全且无需手动字符串切割或正则匹配。
URL 对象:结构化解析和构造 URL
URL 构造函数将一个字符串转换为具有属性的对象,每个部分(协议、主机、路径、查询、哈希等)都可读可写。
- 直接访问字段,比如 url.origin、url.pathname、url.searchParams,避免手写正则提取
- 修改属性后自动同步生成完整 URL,例如改了 url.pathname = '/api/users',url.toString() 就返回更新后的地址
- 对相对 URL 自动解析为绝对地址(需传入 base 参数),适合在非浏览器环境或动态拼接时使用
URLSearchParams:专治查询参数的“瑞士军刀”
它封装了查询字符串(?key=value&foo=bar)的操作逻辑,提供统一、健壮的增删改查接口。
- get() / getAll() 安全取值,自动解码,不担心 %20 或中文乱码
- set() / append() / delete() 修改参数,支持重复键(如多选 checkbox 场景用 append)
- toString() 自动编码并拼接,省去 encodeURIComponent 手动调用,也规避遗漏编码导致的错误
- 可直接传给 fetch() 的 body 或作为 URL 实例的 search 参数,无缝集成
组合使用:构建清晰、可维护的 URL 操作逻辑
典型场景是“从当前 URL 修改某个参数并跳转”——过去容易出错,现在几行代码搞定:
立即学习“Java免费学习笔记(深入)”;
const url = new URL(window.location.href);
url.searchParams.set('page', '3');
url.searchParams.set('sort', 'date');
window.location.href = url.toString();或者初始化搜索参数:
const params = new URLSearchParams({ q: 'js api', per_page: '10' });
fetch(`/search?${params}`); // 自动编码,安全可靠注意边界情况
URL 构造函数会抛出异常(如非法协议),建议包裹 try/catch;URLSearchParams 对空字符串或 null 值会转为空串,但不会报错;两者都不处理 URL 片段(# 后内容)的解析——hash 需单独用 window.location.hash 处理。











