body-parser 是 Express 中用于格式化请求体数据的一个三方库。
以下是一个 body-parser 的常用使用案例。
const express = require('express')const bodyParser = require('body-parser')const app = express()// parse application/x-www-form-urlencodedapp.use(bodyParser.urlencoded({ extended: false }))// parse application/jsonapp.use(bodyParser.json())app.use(function (req, res) { res.setHeader('Content-Type', 'text/plain') res.write('you posted:/n') res.end(JSON.stringify(req.body, null, 2))})
以上代码设置的含义是:项目中所有 Content-Type 是 "application/x-www-form-urlencoded" 或 "application/json" 请求数据都会经过 body-parser 中间件的处理,并设置到 req.body 属性上。
下面就来详细介绍 body-parser 的安装和使用。
$ npm install body-parser
使用也比较简单。
const bodyParser = require('body-parser')
我们是通过调用 bodyParser 对象的方法来获取不同 Content-Type 的数据处理能力的。下面就来介绍。
bodyParser 上一共提供了 4 个方法来使用,分别对应 4 种不同类型的请求体数据。
其中前 2 种是我们最常使用的。接下来分别介绍。
返回能解析 json 数据的中间件,默认匹配 Content-Type 值为 "application/json"(可以通过 options.type 进行控制)。接受任何 Unicode 编码的请求体数据,而且还支持 gzip 和 deflate 压缩算法的自动解压。
解析好的请求体数据会放在 req.body 属性上,无请求体数据则返回一个空对象({})。
这是一个可选参数,不传入则使用默认选项。其他 3 个方法与此类似,在此讲 1 遍后,如果没有特殊情况,后面就不再赘述了。
默认处理 Content-Type 值为 "application/x-www-form-urlencoded" 的请求体数据。
.urlencoded() 中间件还提供了一个布尔参数 urlencoded,用来决定使用哪一个查询解析库来处理请求参数。
qs 与 querystring 的区别在于:querystring 只能解析简单 key-value 对,qs 则支持嵌套对象的 key-value 对的解析,后者功能会更加强大。
默认处理 Content-Type 值为 "text/plain" 的请求体数据。
默认处理 Content-Type 值为 "application/octet-stream" 的请求体数据。
body-parser 并不支持处理 Content-Type 是 "multipart/form-data" 的请求体数据。如果你有这方面的需求,可以参照下面的库进行选择。
express 从 v4.17.0 开始[10],已全面内置了 body-parser 功能,你直接可以通过 express().json() / express().raw()/express().text()/ express().urlencoded() 4 个 API。
在内部,这 4 方法其实是 body-parser 借着 express 暴露出来[11]的。也就是说项目中你无需安装 body-parser 依赖了。
const bodyParser = require('body-parser')/** * Expose middleware */exports.json = bodyParser.jsonexports.query = require('./middleware/query');exports.raw = bodyParser.rawexports.text = bodyParser.textexports.urlencoded = bodyParser.urlencoded
本文介绍了 Express 中用于解析请求体数据的中间件 body-parser。 其实 Express 在 v4.17.0 中已完整内置了 body-parser 的能力,你可以通过 express() 上的 .json()/.urlencoded()/.text()/.raw() 方法访问到。
就介绍到这里了,希望本文对你有所帮助,感谢阅读,再见。
[1]type-is: https://www.npmjs.org/package/type-is#readme
[2]bytes: https://www.npmjs.com/package/bytes
[3]MDN 上 JSON.parse() 的使用文档: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse#Example.3A_Using_the_reviver_parameter
[4]busboy: https://www.npmjs.org/package/busboy#readme
[5]connect-busboy: https://www.npmjs.org/package/connect-busboy#readme
[6]multiparty: https://www.npmjs.org/package/multiparty#readme
[7]connect-multiparty: https://www.npmjs.org/package/connect-multiparty#readme
[8]formidable: https://www.npmjs.org/package/formidable#readme
[9]multer: https://www.npmjs.org/package/multer#readme
[10]从 v4.17.0 开始: https://expressjs.com/en/4x/api.html#express.json
[11]body-parser 借着 express 暴露出来: https://github.com/expressjs/express/blob/4.18.2/lib/express.js#L78
本文链接:http://www.28at.com/showinfo-26-75357-0.htmlBody-Parser:一个格式化请求体数据的 Express 三方库
声明:本网页内容旨在传播知识,不代表本站观点,若有侵权等问题请及时与本网联系,我们将在第一时间删除处理。