关于此工具
统一资源定位符(URL,Uniform Resource Locator,RFC 3986)是互联网世界的唯一地址标准。一个完整的现代 URL 由 Protocol 协议方案、Hostname 主机域名、Port 端口、Pathname 资源路径、Query 查询参数以及 Hash 锚点片段多层嵌套组合而成。在日常前后端排错、接口鉴权分析、广告跟踪与微服务路由排查中,人工拆解深层参数极其费力。本工具提供纯前端现代 URL 结构树形解析,将复杂的查询参数自动提取为表格与 JSON 字典。
如何使用本工具(操作步骤)
粘贴或输入待分析的 URL 网址
在顶部输入框粘贴完整的 HTTP/HTTPS 链接,或包含大量查询参数的相对接口路径,支持自动解码特殊字符。
查看拆解的组件与参数字典
工具即刻分栏呈现:协议(Protocol)、域名(Host)、端口(Port)、路径(Path)以及格式化的 GET 查询参数键值对表格。
复制单个参数或导出 JSON
点击单行即可一键复制提取出的具体参数值,也可以将整组查询参数以结构化 JSON 对象的形式一键导出应用。
支持全套现代 WHATWG URL 标准
严格遵循现代浏览器官方 WHATWG URL 规范解析,精准区分 `origin`、`host` 与 `hostname` 的技术边界,拒绝正则切分产生的误判。
智能提取并格式化 GET 参数字典
自动将繁杂的 `?key1=val1&key2=val2` 拆解为可视化的键值对明细,并自动完成百分号(%XX)解码,直观呈现原本参数。
纯本地离线解析,隐私零上传
解析完全在本地浏览器内存中进行,即使 URL 中包含用户鉴权 Token、SSO 回调地址或内部测试环境内网 IP,也绝无泄密风险。
URL 组件概念常识与开发避坑指南
- •厘清 `host` 与 `hostname` 的区别:`hostname` 纯粹代表域名或 IP(如 `example.com`);而 `host` 会在存在非默认端口时携带端口号(如 `example.com:8080`),配置 CORS 跨域白名单时务必区分清楚。
- •Hash 锚点片段(`#hash`)永远不会发送给后端服务器:无论你在前端如何修改 `#` 后面的内容,浏览器向服务器发起 HTTP 请求时都会自动截断并丢弃 Hash 部分。锚点仅用于前端路由与页面滚动定位。
- •同一个 Key 出现多次的数组传参陷阱:如 `?id=1&id=2`,使用简单的 `Object.fromEntries` 会导致后一个值覆盖前一个值。获取多重值必须使用 `searchParams.getAll('id')` 提取数组。
代码与转换对比示例
包含复杂参数与锚点的完整 URL 拆解剖析示例
https://api.example.com:8080/v1/users/search?keyword=前端&page=2&sort=desc#results• Protocol (协议) : https:
• Hostname (主机) : api.example.com
• Port (端口) : 8080
• Pathname (路径) : /v1/users/search
• Search (查询串) : ?keyword=前端&page=2&sort=desc
• Hash (锚点) : #results* 参数中的“前端”被自动完成解码,避免呈现为晦涩的 `%E5%89%8D%E7%AB%AF`。
现代 JavaScript 原生 URL API 核心代码
const myUrl = new URL("https://example.com/path?foo=1&bar=hello#title");
console.log(myUrl.hostname); // "example.com"
console.log(myUrl.pathname); // "/path"const params = Object.fromEntries(myUrl.searchParams.entries());
console.log(params); // { foo: "1", bar: "hello" }
console.log(myUrl.searchParams.get("foo")); // "1"* `URL` 与 `URLSearchParams` 是所有现代前端浏览器与 Node.js 原生标配接口。
常见问题解答
Q: 为什么相对路径(如 `/api/login`)直接传给 `new URL()` 会报错?
A: 因为根据 WHATWG 规范,URL 对象必须包含合法的协议方案与主机名。解析相对路径时,必须提供第二个 base 基准参数,如 `new URL('/api/login', window.location.origin)`。
Q: URL 中允许直接出现空格或中文吗?
A: 在底层网络传输协议上不允许。浏览器地址栏为了美观会展示中文,但在实际发送 HTTP 报文前,浏览器会自动将空格转为 `%20`,将汉字转为 UTF-8 百分号编码字节串。
Q: 不同端口代表不同的跨域源(Origin)吗?
A: 是的。根据同源策略(Same-Origin Policy),只要“协议(Protocol)”、“域名(Hostname)”或“端口(Port)”三者中有任何一个不一致,都被浏览器视作完全不同的跨域源,需要配置 CORS 许可。