当前位置:首页 > 科技  > 软件

Qs 和 Querystring:解析和格式化 URL query 字符串的工具库

来源: 责编: 时间:2024-01-02 09:27:53 314观看
导读今天介绍两个库 qs、querystring,但是作用一样,都是用来解析和格式化 URL query 字符串(URL query string)的工具库。背景在学习 express 的中间件 body-parser 的文档[1]时,bodyParser.urlencoded([options]) 的 options

今天介绍两个库 qs、querystring,但是作用一样,都是用来解析和格式化 URL query 字符串(URL query string)的工具库。rk228资讯网——每日最新资讯28at.com

背景

在学习 express 的中间件 body-parser 的文档[1]时,bodyParser.urlencoded([options]) 的 options 参数有一个 extended 参数,是个布尔值。rk228资讯网——每日最新资讯28at.com

// parse application/x-www-form-urlencodedapp.use(bodyParser.urlencoded({ extended: false }))// parse application/x-www-form-urlencodedapp.use(bodyParser.urlencoded({ extended: true }))

extended 控制 body-parser 内部在解析  URL query 字符串时,内部使用哪个工具库:rk228资讯网——每日最新资讯28at.com

  • 为 false 时,body-parser 内部使用的是 querystring(只支持单层对象和数组的解析)
  • 为 true 时,body-parser 内部使用的是 qs(能支持嵌套对象和数组的解析)

extended 默认值虽然为 true,但这个默认值已被弃用了。我们需要学习 qs 和 querystring 之间的区别并选择适当的进行设置。rk228资讯网——每日最新资讯28at.com

我们下面就分别来学习。rk228资讯网——每日最新资讯28at.com

querystring

querystring 开始是一个三方工具库,后面内置到了 Node.js 中[2],querystring 支持单层对象和数组的解析和格式化rk228资讯网——每日最新资讯28at.com

你可以通过下列方式引用 querystring:rk228资讯网——每日最新资讯28at.com

const querystring = require('node:querystring');

querystring 提供的核心方法就 2 个:.parse() 和 .stringify() 有点类似与 JSON.parse()/JSON.stringify()。rk228资讯网——每日最新资讯28at.com

querystring.parse()

.parse() 用来将 URL query 字符串转换成对象和数组。rk228资讯网——每日最新资讯28at.com

const querystring = require('node:querystring'); querystring.parse('foo=bar&abc=xyz') // { foo: 'bar', abc: 'xyz'  }

URL query 字符串中,键值对采用 = 连接,每个键值对之间采用 & 连接。rk228资讯网——每日最新资讯28at.com

如果 URL query 字符串包含一样的键名,那么会作为数组解析。rk228资讯网——每日最新资讯28at.com

const querystring = require('node:querystring'); querystring.parse('foo=bar&abc=xyz&abc=123')/*{  "foo": "bar",  "abc": ["xyz", "123"]}*/

.parse() 方法的完整语法是:querystring.parse(str[, sep[, eq[, options]]]) 。rk228资讯网——每日最新资讯28at.com

  • 第 2 个参数 sep 用于控制键值对之间的间隔,默认值 '&'
  • 第 3 个参数 eq 用于控制键值之间的间隔,默认值 '='
const querystring = require('node:querystring'); querystring.parse('foo:bar;abc:xyz;abc:123', ';', ':')/*{  "foo": "bar",  "abc": ["xyz", "123"]}*/

querystring.stringify()

.stringify() 用来将对象或数组转换成 URL query 字符串,是 .parse() 方法的逆向操作。rk228资讯网——每日最新资讯28at.com

querystring.stringify({ foo: 'bar', baz: ['qux', 'quux'], corge: '' });// Returns 'foo=bar&baz=qux&baz=quux&corge='

.stringify() 方法的完整语法是:querystring.stringify(obj[, sep[, eq[, options]]])。rk228资讯网——每日最新资讯28at.com

  • 第 2 个参数 sep 用于控制键值对之间的间隔,默认值 '&'
  • 第 3 个参数 eq 用于控制键值之间的间隔,默认值 '='
querystring.stringify({ foo: 'bar', baz: ['qux', 'quux'], corge: '' }, ';', ':');// Returns 'foo:bar;baz:qux;baz:quux;corge:'

qs

qs[3] 是对 querystring 工具库的扩展,能支持嵌套对象和数组的解析和格式化。rk228资讯网——每日最新资讯28at.com

qs.parse()

.parse() 用来将 URL query 字符串转换成对象和数组·。rk228资讯网——每日最新资讯28at.com

var qs = require('qs');qs.parse('foo=bar&abc=xyz') // { foo: 'bar', abc: 'xyz'  }qs.parse('a=b&a=c') // { a: ['b', 'c'] }qs.parse('a[]=b&a[]=c') // { a: ['b', 'c'] }

可以发现,qs.parse() 对数组的解析是兼容 querystring.parse() 的,还可以在键中使用 [] 指定显式指定是数组。rk228资讯网——每日最新资讯28at.com

此外,qs.parse() 还支持嵌套对象的解析。rk228资讯网——每日最新资讯28at.com

qs.parse('foo[bar]=baz')/*{    foo: {        bar: 'baz'    }}*/qs.parse('foo[bar][baz]=foobarbaz')/*{    foo: {        bar: {            baz: 'foobarbaz'        }    }}*/

键部分,[nestedProp] 中的 nestdProp 会被看作嵌套属性解析。rk228资讯网——每日最新资讯28at.com

不过为了减少这个功能的滥用,qs.parse() 默认设置了 5 层的深度限制,可以通过 depth option 重置。rk228资讯网——每日最新资讯28at.com

qs.parse('a[b][c][d][e][f][g][h][i]=j')/*{    a: {        b: {            c: {                d: {                    e: {                        f: {                            '[g][h][i]': 'j'                        }                    }                }            }        }    }}*/qs.parse('a[b][c][d][e][f][g][h][i]=j', { depth: 1 })/*{ a: { b: { '[c][d][e][f][g][h][i]': 'j' } } }*/

qs 嵌套属性语法跟数组语法是重复的。数组中的索引和对象中的键之间的唯一区别是括号之间的值必须是数字才能创建数组,否则就是对象。rk228资讯网——每日最新资讯28at.com

qs.parse('a[1]=c&a[0]=b') // { a: ['b', 'c'] }qs.parse('foo[bar]=baz') // { foo: { bar: 'baz' } }

不过为了减少这个功能的滥用,qs.parse() 默认将数组中指定的索引值限制到最大 20 ,任何索引大于 20 的索引都会作为对象属性使用。可以通过 arrayLimit option 重置。rk228资讯网——每日最新资讯28at.com

qs.parse('a[100]=b') // { a: { '100': 'b' } }qs.parse('a[1]=b', { arrayLimit: 0 }) // { a: { '1': 'b' } }

qs.stringify()

qs.stringify() 用来将对象或数组转换成 URL query 字符串,是 qs.parse() 方法的逆向操作。rk228资讯网——每日最新资讯28at.com

qs.stringify({ a: 'b' }) // 'a=b'qs.stringify({ a: { b: 'c' } }) // 'a%5Bb%5D=c'

字符串化时,qs 默认对 URI 进行编码输出。当然,也可以通过指定 encode option 设置成 false 指定不用编码。rk228资讯网——每日最新资讯28at.com

qs.stringify({ a: { b: 'c' } }, { encode: false }) // a[b]=c

还有字符串化数组。rk228资讯网——每日最新资讯28at.com

qs.stringify({ a: ['b', 'c', 'd'] }) // 'a[0]=b&a[1]=c&a[2]=d'

注意,这里跟 querystring.stringify() 不同的是,数组默认会赋予索引标识([]),可以通过将 indices option 设置为 false 来覆盖此设置。rk228资讯网——每日最新资讯28at.com

qs.stringify({ a: ['b', 'c', 'd'] }, { indices: false })// 'a=b&a=c&a=d'

rk228资讯网——每日最新资讯28at.com

delimiter 选项参数

qs.stringify()/qs.parse() 还支持通过 delimiter 选项参数自定义键值对分隔符。rk228资讯网——每日最新资讯28at.com

qs.parse('a=b;c=d', { delimiter: ';' }) // { a: 'b', c: 'd' }

不过,目前并不支持自定义键值之间的分隔符。rk228资讯网——每日最新资讯28at.com

总结

本文介绍了两个库:qs 和 querystring。他们作用是一样的,都是用来解析和格式化 URL query 字符串的工具库。rk228资讯网——每日最新资讯28at.com

qs 是对 querystring 工具库的扩展。querystring 支持单层对象和数组的解析和格式化;而 qs 则能支持嵌套对象和数组的解析和格式化。如果 URL query 字符串不是那种嵌套结构,那么使用 Node.js 内置的 querystring 模块就够了。rk228资讯网——每日最新资讯28at.com

对应到 express 的 body-parser 中间件的使用,那就是在调用 bodyParser.urlencoded() 时,extended 选项设置成 false 就够了。rk228资讯网——每日最新资讯28at.com

// express v4.16.0 之前// ===var express = require('express')var bodyParser = require('body-parser')var app = express()// create application/x-www-form-urlencoded parservar urlencodedParser = bodyParser.urlencoded({ extended: false })// POST /login gets urlencoded bodiesapp.post('/login', urlencodedParser, function (req, res) {  res.send('welcome, ' + req.body.username)})// express v4.16.0 之后(包含)// ===var express = require('express')var app = express()// create application/x-www-form-urlencoded parservar urlencodedParser = express.urlencoded({ extended: false })// POST /login gets urlencoded bodiesapp.post('/login', urlencodedParser, function (req, res) {  res.send('welcome, ' + req.body.username)})

希望本文内容对你有所帮助,感谢阅读,Happing Coding!rk228资讯网——每日最新资讯28at.com

参考资料

[1]body-parser 的文档:https://www.npmjs.com/package/body-parser#body-parserrk228资讯网——每日最新资讯28at.com

[2]内置到了 Node.js 中:https://nodejs.org/api/querystring.htmlrk228资讯网——每日最新资讯28at.com

[3]qs:https://www.npmjs.com/package/qsrk228资讯网——每日最新资讯28at.com

本文链接:http://www.28at.com/showinfo-26-54993-0.htmlQs 和 Querystring:解析和格式化 URL query 字符串的工具库

声明:本网页内容旨在传播知识,若有侵权等问题请及时与本网联系,我们将在第一时间删除处理。邮件:2376512515@qq.com

上一篇: 用RASP五步轻松保护云端无服务器架构

下一篇: 多人多团队应该如何实施微服务?版本如何管理?

标签:
  • 热门焦点
  • 一篇聊聊Go错误封装机制

    %w 是用于错误包装(Error Wrapping)的格式化动词。它是用于 fmt.Errorf 和 fmt.Sprintf 函数中的一个特殊格式化动词,用于将一个错误(或其他可打印的值)包装在一个新的错误中。使
  • 得物效率前端微应用推进过程与思考

    一、背景效率工程随着业务的发展,组织规模的扩大,越来越多的企业开始意识到协作效率对于企业团队的重要性,甚至是决定其在某个行业竞争中突围的关键,是企业长久生存的根本。得物
  • 自动化在DevOps中的力量:简化软件开发和交付

    自动化在DevOps中扮演着重要角色,它提升了DevOps的效能。通过自动化工具和方法,DevOps团队可以实现以下目标:消除手动和重复性任务。简化流程。在整个软件开发生命周期中实现更
  • 使用LLM插件从命令行访问Llama 2

    最近的一个大新闻是Meta AI推出了新的开源授权的大型语言模型Llama 2。这是一项非常重要的进展:Llama 2可免费用于研究和商业用途。(几小时前,swyy发现它已从LLaMA 2更名为Lla
  • 电视息屏休眠仍有网络上传 爱奇艺被质疑“薅消费者羊毛”

    记者丨宁晓敏 见习生丨汗青出品丨鳌头财经(theSankei) 前不久,爱奇艺发布了一份亮眼的一季报,不仅营收和会员营收创造历史最佳表现,其运营利润也连续6个月实现增长。自去年年初
  • 自律,给不了Keep自由!

    来源 | 互联网品牌官作者 | 李大为编排 | 又耳 审核 | 谷晓辉自律能不能给用户自由暂时不好说,但大概率不能给Keep自由。近日,全球最大的在线健身平台Keep正式登陆港交所,努力
  • 小米汽车电池信息疑似曝光:容量101kWh,支持800V高压快充

    7月14日消息,今日一名博主在社交媒体发布了一张疑似小米汽车电池信息的照片,显示该电池包正是宁德时代麒麟电池,容量为101kWh,电压为726.7V,可以预测小
  • 四年持续更迭坚持探索行业无人之境,HarmonyOS 4带来五大升级多项创新

    除了华为每年新发布的旗舰手机系列,上亿花粉更加期待鸿蒙系统每次的跨版本大更新。8月4日,HarmonyOS 4于HDC 2023正式发布,这也是该系统历经四年的再
  • 亲历马斯克血洗Twitter,硅谷的苦日子在后头

    文/刘哲铭  编辑/李薇  马斯克再次挥下裁员大刀。  美国时间11月14日,Twitter约4400名外包员工遭解雇,此次被解雇的员工的主要工作为内容审核等。此前,T
Top