使用qs.parse读取URL查询参数不解码,处理+号转空格及类型错误
解决方案
问题根因
- 类型报错翻译:你遇到的报错翻译为「类型错误:类型为
string | string[] | ParsedQs | ParsedQs[] | undefined的参数无法赋值给类型为string的参数」。触发原因是qs.parse的返回值中每个字段的默认类型为多类型联合,可能是字符串、字符串数组、ParsedQs对象、ParsedQs对象数组或者未定义,未做类型校验直接赋值给声明为string类型的变量就会触发TS校验报错。 - 加号被转成空格的原因:qs默认会对查询参数执行URL解码,按照URI规范查询参数中的
+会被解码为空格,你使用的第三方URL没有对邮箱里的+做编码处理,所以会出现这个问题。 - 替换逻辑的隐藏问题:字符串的
replace方法不会修改原字符串,而是返回替换后的新字符串,你之前的写法没有赋值给变量,就算类型问题解决了也不会生效。
最优解决方案(推荐)
直接在qs解析阶段禁用解码逻辑,从根源避免+被转义,不需要后续替换操作,不会出现误伤合法字符的问题:
const parseRes = qs.parse(window.location.search, { ignoreQueryPrefix: true, decodeURI: (rawStr) => rawStr // 核心配置:自定义解码逻辑直接返回原始字符串,不做任何解码 }) // 先做类型收窄,确保拿到字符串类型的邮箱值 const email = typeof parseRes.email === 'string' ? parseRes.email : ''
替换逻辑的修复方案(不推荐)
如果你需要保留其他参数的默认解码逻辑,只修复邮箱的加号问题,可以按以下方式修改代码,同时解决类型报错和替换不生效的问题:
const parseRes = qs.parse(window.location.search, { ignoreQueryPrefix: true }) // 类型收窄避免类型报错 let email = typeof parseRes.email === 'string' ? parseRes.email : '' // 替换后重新赋值给变量 if (email) { email = email.replace(/ /g, '+') }
内容的提问来源于stack exchange,提问作者Kiran Dash
相关产品推荐
相关产品推荐

