Express内置的中间件(express.json和express.urlencoded)格式的请求体数据

目录

Express内置的中间件

express.json 中间件的使用

express.urlencoded 中间件的使用

express.urlencoded([options]) 

解析req.body的兼容写法

Express内置的中间件

自 Express 4.16.0 版本开始，Express 内置了 3 个常用的中间件，极大的提高了 Express 项目的开发效率和体验

1. express.static 快速托管静态资源的内置中间件，例如： HTML 文件、图片、CSS 样式等（无兼容性）

2. express.json 解析 JSON 格式的请求体数据（有兼容性，仅在 4.16.0+ 版本中可用）

3. express.urlencoded 解析 URL-encoded 格式的请求体数据（有兼容性，仅在 4.16.0+ 版本中可用）

express.json 中间件的使用

1. express.json() 中间件，解析表单中的 JSON 格式的数据

2. 案例代码

const express = require('express')
const app = express()

// 注意：除了错误级别的中间件，其他的中间件，必须在路由之前进行配置
// 通过 express.json() 这个中间件，解析表单中的 JSON 格式的数据
app.use(express.json())

app.post('/user', (req, res) => {
  // 在服务器，可以使用 req.body 这个属性，来接收客户端发送过来的请求体数据
  // 默认情况下，如果不配置解析表单数据中间件，则 req.body 默认等于 undefined
  console.log(req.body)
  res.send('ok')
})

app.listen(3000, () => {
  console.log('running……')
})

express.urlencoded 中间件的使用

1. express.urlencoded 解析 URL-encoded 格式的请求体数据

2. 案例代码

 

const express = require('express')
const app = express()

// 通过 express.urlencoded() 这个中间件，来解析表单中的 url-encoded 格式的数据
app.use(express.urlencoded({ extended: false }))

app.post('/book', (req, res) => {
  console.log(req.body)
  res.send(req.body)
})

app.listen(3000, () => {
  console.log('running……')
})

express.urlencoded([options]) 

这是 Express 中内置的中间件函数。它使用 urlencoded 有效负载解析传入的请求，并且基于 body-parser。

返回仅解析 urlencoded 正文并仅查看 Content-Type 标头与 type 选项匹配的请求的中间件。此解析器仅接受正文的 UTF-8 编码，并支持 gzip 和 deflate 编码的自动膨胀。‘

包含解析数据的新 body 对象在中间件（即 req.body）之后填充到 request 对象上，如果没有要解析的主体、Content-Type 不匹配或发生错误，则填充一个空对象（{}）。该对象将包含键值对，其中值可以是字符串或数组（当 extended 为 false 时）或任何类型（当 extended 为 true 时）

由于 req.body 的形状基于用户控制的输入，因此该对象中的所有属性和值都是不可信的，应该在信任之前进行验证。例如，req.body.foo.toString() 可能以多种方式失败，例如 foo 可能不存在或可能不是字符串，toString 可能不是函数，而是字符串或其他用户输入。

下表描述了可选 options 对象的属性。

The following table describes the properties of the optional options object.

解析req.body的兼容写法

包含在请求正文中提交的数据键值对。默认情况下，它是 undefined，并在你使用 body-parser 和 multer 等正文解析中间件时填充。

由于 req.body 的形状基于用户控制的输入，因此该对象中的所有属性和值都是不可信的，应在信任之前进行验证。例如，req.body.foo.toString() 可能以多种方式失败，例如 foo 可能不存在或可能不是字符串，并且 toString 可能不是函数而是字符串或其他用户输入。

以下示例显示如何使用正文解析中间件填充 req.body。

const app = require('express')()
const bodyParser = require('body-parser')
const multer = require('multer') // v1.0.5
const upload = multer() // for parsing multipart/form-data

app.use(bodyParser.json()) // for parsing application/json
app.use(bodyParser.urlencoded({ extended: true })) // for parsing application/x-www-form-urlencoded

app.post('/profile', upload.array(), (req, res, next) => {
  console.log(req.body)
  res.json(req.body)
})