URL API 提供解析、构造和修改网址的能力,通过 new URL() 可访问协议、主机、路径等部分;结合 searchParams 和 URLSearchParams 精准操作查询参数;支持相对路径与基础 URL 合并;自动处理编码,避免手动拼接错误。

JavaScript 提供了多种内置 API 来操作和处理 URL,让开发者可以轻松解析、构造和修改网址。以下是几个实用且常用的 URL 操作方法和接口。
URL 构造函数:解析与生成 URL
URL 是最核心的 API,可用于解析、访问和重建 URL 的各个部分。
创建一个 URL 实例后,可以方便地读取或修改协议、主机、路径、查询参数等:
const url = new URL(‘https://example.com:8080/path/to/page?name=js&v=1.0#section’);
console.log(url.protocol); // “https:”
console.log(url.hostname); // “example.com”
console.log(url.port); // “8080”
console.log(url.pathname); // “/path/to/page”
console.log(url.search); // “?name=js&v=1.0”
console.log(url.hash); // “#section”
也可以通过 searchParams 属性操作查询字符串,非常实用。
立即学习“Java免费学习笔记(深入)”;
URLSearchParams:精准控制查询参数
URLSearchParams 可以单独使用,也可通过 URL 实例访问,专门用于处理 query string。
常用方法包括:
- get(key):获取指定参数值
- set(key, value):设置或更新参数
- append(key, value):追加新参数(支持重复键)
- delete(key):删除参数
- toString():返回处理后的查询字符串
const params = new URLSearchParams(url.search);
params.get(‘name’); // “js”
params.set(‘v’, ‘2.0’); // 更新版本
params.append(‘tag’, ‘web’); // 添加新参数
url.search = params.toString(); // 应用回 URL
这个 API 避免了手动拼接字符串的错误,特别适合动态构建请求参数。
一键操作,智能生成专业级PPT
37
查看详情
相对路径与基础 URL 处理
URL 构造函数支持传入相对路径和基础 URL,自动进行合并:
const relativeUrl = new URL(‘/api/data’, ‘https://example.com’);
// 结果:https://example.com/api/data
这种写法在构建 API 请求地址时非常有用,尤其是配合配置的基础地址使用。
编码与解码特殊字符
URL 中不能直接包含空格、中文等字符,需进行编码。JavaScript 提供了:
- encodeURI():编码整个 URL,保留合法符号如 : / ?
- encodeURIComponent():编码参数值,更彻底,适合 query 或 path 片段
- decodeURI() 和 decodeURIComponent():对应解码
encodeURIComponent(‘你好.js’); // “%E4%BD%A0%E5%A5%BD.js”
URL 和 URLSearchParams 内部会自动处理编码,但手动拼接时需注意使用正确方法。
基本上就这些。合理使用 URL 和 URLSearchParams 能大幅提升处理链接的准确性和可维护性,避免正则或字符串切割带来的问题。
大家都在看:
JavaScript动态文本替换:从单行输入实现正则表达式查找与替换
JavaScript中的性能优化:除了防抖和节流,还有哪些高级模式?
JavaScript中二维数组的map()方法深度解析与正确实践
JavaScript 的装饰器提案目前处于哪个阶段,如何利用 Babel 实现方法装饰?
































暂无评论内容