JavaScript获取URL参数的几种方法

avatar
作者
筋斗云
阅读量:2

前言

在前端开发中,处理URL参数是一个常见的任务,尤其是在没有框架支持的情况下。虽然许多框架提供了方便的方法来获取URL参数,但有时我们需要依赖原生JavaScript来完成这个任务。这也是面试中经常出现的问题之一。今天让我们一起来探讨如何利用原生JavaScript来获取URL参数值。
 

获取方法总结

原生JS获取URL链接参数的方法有好几种,我们一起来学习一下常见的几种。

1.使用正则表达式

2.利用a标签内置方法

3.利用split分割方法

4.使用URLSearchParams方法

具体实现

方法一: 正则表达式

function queryURLParams(url, paramName) {     // 正则表达式模式,用于匹配URL中的参数部分。正则表达式的含义是匹配不包含 ?、&、= 的字符作为参数名,之后是等号和不包含 & 的字符作为参数值     let pattern = /([^?&=]+)=([^&]+)/g;     let params = {};          // match用于存储正则匹配的结果     let match;     // while 循环和正则表达式 exec 方法来迭代匹配URL中的参数     while ((match = pattern.exec(url)) !== null) {         // 在字符串url中循环匹配pattern,并对每个匹配项进行解码操作,将解码后的键和值分别存储在key和value变量中         let key = decodeURIComponent(match[1]);         let value = decodeURIComponent(match[2]);                  if (params[key]) {             if (Array.isArray(params[key])) {                 params[key].push(value);             } else {                 params[key] = [params[key], value];             }         } else {             // 参数名在 params 对象中不存在,将该参数名和对应的值添加到 params 对象中             params[key] = value;         }     }          if (!paramName) {         // 没有传入参数名称, 返回含有所有参数的对象params         return params;     } else {         if (params[paramName]) {             return params[paramName];         } else {             return '';         }     } }  let url = "http://www.baidu.com?name=elephant&age=25&sex=male&num=100&name=lion"; console.log(queryURLParams(url)); // 返回所有参数对象 console.log(queryURLParams(url, 'name')); // 返回参数名为 'name' 的所有值 console.log(queryURLParams(url, 'age')); // 返回参数名为 'age' 的值 console.log(queryURLParams(url, 'color')); // 返回""

正则表达式解释: 

  • ([^?&=]+):这部分是一个捕获组,表示匹配不包含 ?&= 的任意字符的一个或多个,即匹配参数名部分。
  • =:表示匹配参数名和参数值之间的等号。
  • ([^&]+):这部分也是一个捕获组,表示匹配不包含 & 的任意字符的一个或多个,即匹配参数值部分。
  • g:表示使用全局匹配模式,即匹配目标字符串中所有符合模式的部分。

方法二: 利用a标签

a标签内置的方法能够快速且方便地获取URL参数,

它的原理主要就是利用了a标签得到一些内置属性,如href、hash、search等属性。

考虑到URL中的哈希部分,在函数queryURLParams(url)中,会检查URL中的哈希部分是否存在,如果存在则将哈希值存储到参数对象中,并将属性名设置为"HASH"。这样在返回的参数对象中,如果URL中有哈希部分,就可以通过"HASH"来访问哈希值。

let URL = "http://www.baidu.com?name=elephant&age=25&sex=male&num=100#smallpig"   function queryURLParams(url) {     // 1.创建a标签     let link = document.createElement('a');     link.href = url;     let searchUrl = link.search.substr(1); // 获取问号后面字符串     let hashUrl = link.hash.substr(1); // 获取#后面的值     let obj = {}; // 声明参数对象     // 2.向对象中进行存储     hashUrl ? obj['HASH'] = hashUrl : null; // #后面是否有值      let list = searchUrl.split("&");     for (let i = 0; i < list.length; i++) {       let arr = list[i].split("=");       obj[arr[0]] = arr[1];     }     return obj;   }   console.log(queryURLParams(URL))

上段代码中先创建了一个a标签,然后就可以根据a标签的属性分别得到url的各个部分了,这其实和Vue的路由跳转获取参数有点类似。

1. 将传入的URL赋值给 `<a>` 标签的 `href` 属性的目的是利用浏览器提供的原生 API 来帮助实现 URL 参数的解析。通过将URL赋值给 `<a>` 标签的 `href` 属性,浏览器会自动解析这个URL,包括提取其中的协议、主机、路径、查询参数等各个部分,从而方便我们对这个URL进行进一步的操作。

2. 通过`link.search.substr(1)`和`link.hash.substr(1)`可以获取URL中问号后面的字符串和`#`后面的值,是因为浏览器在解析URL后会将这些信息存储在`<a>`标签对象的对应属性中。具体来说:
   - `link.search` 包含了 URL 中问号后面的部分(即查询参数部分)。
   - `link.hash` 包含了 URL 中`#`后面的部分(即片段部分)。
   - 使用`substr(1)`是为了去掉字符串中的问号或`#`字符,只留下真正的参数内容或片段内容。
 

方法三: split分割法

这种方法利用了split可以以某个字符讲字符串分割为数组的特点,巧妙地将各个参数分割出来。

function getUrlParams(url, paramName) {     // 从 URL 中提取查询参数部分     const queryString = url.split('?')[1];          // 如果没有查询参数,返回空对象     if (!queryString) {         return {};     }          // 处理带有 hash 地址的情况     const hashIndex = queryString.indexOf('#');     if (hashIndex !== -1) {         queryString = queryString.substring(0, hashIndex);     }          // 将查询参数字符串解析为键值对     const queryParams = {};     queryString.split('&').forEach(param => {         const [key, value] = param.split('=');         // 如果值已经存在,则将其转换为数组存储         if (queryParams[key]) {             if (Array.isArray(queryParams[key])) {                 queryParams[key].push(decodeURIComponent(value));             } else {                 queryParams[key] = [queryParams[key], decodeURIComponent(value)];             }         } else {             queryParams[key] = decodeURIComponent(value);         }     });          // 如果没有指定参数名称,则返回包含所有查询参数的对象     if (!paramName) {         return queryParams;     }          // 如果指定了参数名称     if (queryParams[paramName]) {         return queryParams[paramName];     } else {         // 参数不存在,返回空字符串         return '';     } }  // 示例 URL const url = 'https://example.com?name=John&age=30&name=Jane&gender=male'; const urlWithHash = 'http://xxx.com/#/operations/app?name=John&age=30&name=Jane&gender=male';  console.log(getUrlParams(url));  // 输出: { name: ['John', 'Jane'], age: '30', gender: 'male' }  console.log(getUrlParams(url, 'name')); // 输出: ['John', 'Jane']  console.log(getUrlParams(url, 'age')); // 输出: '30'  console.log(getUrlParams(url, 'city')); // 输出: ''  console.log(getUrlParams(urlWithHash));  // 输出: { name: ['John', 'Jane'], age: '30', gender: 'male' } 
关于hash地址部分

在处理 URL 查询参数时,通常情况下不需要处理 hash 地址部分。

Hash 地址通常用于客户端路由或页面内导航,一般不会包含查询参数信息。

但在某些情况下,可能需要处理带有 hash 地址的 URL,例如:

1. 当需要从 URL 中提取查询参数时,如果 URL 中的查询参数部分后面紧跟着 hash 地址(如 `http://example.com/page?name=John#section2`),需要排除 hash 部分以确保正确提取查询参数。

2. 如果要监听 hash 地址的变化,并根据不同的 hash 地址执行不同的逻辑(如单页面应用路由器),则需要处理 hash 地址的改变并做出响应。 总的来说,在处理 URL 查询参数时一般不需要处理 hash 地址部分,但在特定情况下需要注意并处理。

方法四: URLSearchParams

URLSearchParams方法能够让我们非常方便的获取URL参数,但是存在一定的兼容性问题,官网的解释如下:

URLSearchParams 接口定义了一些实用的方法来处理 URL 的查询字符串。

该接口提供了非常的的方法让我们来处理URL参数,这里我们只介绍如何获取URL参数值,更加详细的使用方法大家可以参考官网。

 let URL = "http://www.baidu.com?name=elephant&age=25&sex=male&num=100"   function queryURLParams(URL) {     let url = URL.split("?")[1];     const urlSearchParams = new URLSearchParams(url);     const params = Object.fromEntries(urlSearchParams.entries());     return params   }   console.log(queryURLParams(URL))

这里我们基本上只用了两行主要代码就实现了参数的解析。需要注意的是urlSearchParams.entries()返回的是一个迭代协议iterator,所以我们需要利用Object.fromEntries()方法将把键值对列表转换为一个对象。

关于迭代协议,大家可以参考官网:迭代协议

总结:

这里介绍了四种方法来实现URL链接参数值的解析,其中使用最为广泛的应该当属split分割法。总的来说,了解和掌握这些方法可以帮助前端开发者更有效地处理URL参数,从而提升开发效率和应对面试中可能出现的相关问题。

广告一刻

为您即时展示最新活动产品广告消息,让您随时掌握产品活动新动态!