李涛自留地
回到顶部
首页 > jQuery学习 > jquery获取url参数怎么写?手动解析比插件稳

jquery获取url参数怎么写?手动解析比插件稳

文章目录

页面上要读 ?id=3 这种参数,非得引一个 query 插件吗?答案取决于两件事:参数里有没有同名键和中文,以及还要不要兼容 IE11。这两条只要占住一条,各家的行为就开始不一样,jquery获取url参数这件事也就没有统一答案。边界先摆清楚,后面才好判断。

结论:十几行代码,自己切

答案是不用插件。取 location.search、去掉前导问号、按 & 切开、再按第一个 = 分成键和值,逐个值解码。每一步都能单独打日志,出错时能定位到具体哪一环。

function getQuery(name) {
  var raw = location.search.slice(1);
  if (!raw) return '';
  var pairs = raw.split('&');
  for (var i = 0; i < pairs.length; i++) {
    var at = pairs[i].indexOf('=');
    if (at < 0) continue;
    if (pairs[i].slice(0, at) !== name) continue;
    var val = pairs[i].slice(at + 1);
    try {
      return decodeURIComponent(val);
    } catch (e) {
      return val;
    }
  }
  return '';
}

拿 ?kw=%E4%B8%AD%E6%96%87&page=2 去调,getQuery('kw') 返回「中文」,getQuery('page') 返回字符串 "2"。前者说明解码只发生了一次,后者提醒你别拿返回值直接做加法。

从地址栏查询串拆到键值对的四段结构

location.search 有个细节值得先记:它取的是地址栏里问号后面那一串,还把问号一起带回来;没有查询串时是空字符串。slice(1) 之前那句判空就是这么来的。第一次写漏了,页面没参数时 split('&') 得到 [''],循环照跑,返回空串,看着像参数不存在,其实一次判断都没进。

键名本身也可能被编码,比如 %E5%85%B3%E9%94%AE=1 这样一对,键是三个百分号转义,直接拿中文去比同样匹配不上。要么先解键再比,要么在发参数的一侧就约定只用 ASCII 键名。

用jquery获取url参数时,真正决定结果的是切和解的先后,不是函数叫什么名字。

为什么说手动解析查询字符串更稳

插件通常干两件事:拿一个正则把整串切成键值对,或者把 $.param 的序列化规则反着推一遍。简单参数上两种做法都没问题,一旦遇到同名键、数组形式的键、编码不统一,行为就不由你控制了。

解码次数也常被插件吃掉。URLSearchParams 在解析时只解一次,而某些插件先把整串解一遍、再逐值解一遍,同一个值就解了两次。值里本来存着 %25E4%25B8%25AD 这种内容时,正确的输出是 %E4%B8%AD;再解一次就变成「中」,把一段字面量当成了待解码内容,属于过度解码。

jQuery 核心库只提供 $.param 这个方向,对象转字符串,没有反向解析。所谓取参插件,是第三方按自己的假设补出来的,假设不同,结果就不同。

五个步骤与一条解码失败的分支

自己切的好处是中间状态可见:切完的数组、没解码的原始值、解码后的结果,都能打印出来对照。

还有一个顺序问题。先解码再按 & 切分是错的:值里如果有一个 %26,解码后变成 &,一对参数会被切成两对。正确顺序是先用原始串切,再对每个值单独解码。

中文参数的解码,和那个加号

中文是最容易出错的一步。decodeURIComponent 不是「解不开就原样返回」,遇到孤立的百分号会抛错。在 node 里跑 decodeURIComponent('100%'),输出是 URIError: URI malformed,整行带着堆栈。

所以解码要包在 try/catch 里,失败就把原始值留着交给下游。一次搜索词带 % 的请求里,后端把用户的「100%」直接拼进 URL 没有编码,前端解的时候脚本停住,控制台第一行就是这句 URI malformed。

加号是另一回事。URLSearchParams 把 + 当空格,decodeURIComponent 不认 +。同一串 q=a+b,前者给出 "a b",后者给出 "a+b"。

node -e "console.log(new URLSearchParams('q=a+b').get('q'))"
node -e "console.log(decodeURIComponent('a+b'))"

第一条打印 a b,中间一个空格;第二条打印 a+b,加号原样留着。PHP 的 $_GET 走前一种规则,手动解出来的值直接拿去和后端比对,会差一个字符。

两边规则不一致时,以谁为准得提前定。接口由 PHP 写就按加号当空格处理,接口用 node 的 URLSearchParams 就保留加号。定不下来,就先把值统一 encodeURIComponent 再发出去。

数组参数:a[]=1&a[]=2 和 a=1&a=2 不是一回事

后端按 PHP 的习惯拼参数时,jquery获取url参数还会碰到 a[]=1&a[]=2 这种键名。jQuery 的 $.param({a:[1,2]}) 生成的是 a%5B%5D=1&a%5B%5D=2,解码回来正是带方括号的形式。

重复键与方括号键在两种写法下的结果对比

手动按 = 切开,键是字符串 "a[]",拿 'a' 去比对永远匹配不上,函数返回空。代码不报错,只是拿不到值,这类静默失败最难查,也最容易被插件掩盖。

换成 a=1&a=2,手动循环如果每次命中就 return,只拿到第一个 1;写成覆盖赋值,留下的是最后一个 2。上面那个 getQuery 就是命中即返回的写法,想留最后一个,把 return 换成赋值、循环走完再返回。两种写法都不算错,错在你没意识到自己选了哪一种。

URLSearchParams 对这两种键名的处理更明确:get 给第一个值,getAll 给全部。

var qs = new URLSearchParams('a=1&a=2');
qs.get('a');        // '1',第一个
qs.getAll('a');     // ['1', '2']

var qs2 = new URLSearchParams('a[]=1&a[]=2');
qs2.get('a');       // null,键名其实是 a[]
qs2.getAll('a[]');  // ['1', '2']

注释里的返回值来自 node 的实际输出,浏览器控制台结果一致。手动循环最容易和它差开的一点就是:覆盖赋值留最后一个,get 给第一个。

这些情形,别自己切

参数是嵌套结构时,比如 a[b][c]=1,手写的两层循环会变成一个半成品解析器。

要解的不是 location.search 而是整条 URL,或者查询串藏在 hash 后面,取哪一段得先想清楚。项目里已经统一引入 polyfill、或者框架自带路由参数解析的,跟着那套走,同一个工程并存两套取参逻辑,比用错一套更难查。

只取一个 ASCII 参数、又不用兼容老浏览器时,jquery获取url参数一行就够:new URLSearchParams(location.search).get('id'),另写函数属于多余。

必须支持 IE11 这类没有 URLSearchParams 的环境时,没有原生兜底,就退回手动切分。上面那个函数留着别删。

若非作者标注皆为李涛自留地原创文章,转载或复制请以超链接形式并注明出处。