express.urlencoded([options])

此中间件在 Express v4.16.0 及更高版本中可用。

这是 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 对象的属性。