express.urlencoded 中间件：详解原理和手写示例

2023-12-17 02:24:49

从头剖析 express.urlencoded 中间件

简介

在构建 RESTful API 和处理用户提交的表单时，Node.js 开发人员经常使用 Express.js 框架。Express.js 提供了 express.urlencoded 中间件，它专门设计用来解析内容类型为 application/x-www-form-urlencoded 的传入请求体，这正是 HTML 表单采用的内容类型。

原理

express.urlencoded 中间件的作用是将请求体中的表单数据解析成 JavaScript 对象。它使用 querystring 模块来处理请求体，将键值对形式的表单数据解析为一个对象。这个对象可以通过 req.body 属性访问。

解析过程涉及以下步骤：

请求头检查： 中间件首先检查请求头中 Content-Type 字段的值，以确定请求体是否为 application/x-www-form-urlencoded。如果没有指定 Content-Type 字段，则 middleware 会跳过解析。
解码： 如果 Content-Type 字段正确设置，中间件会解码请求体中的数据。URL 编码用于对请求体进行编码，它将特殊字符（如空格）转换为十六进制表示形式。
解析： 解码后，中间件会将表单数据解析成一个 JavaScript 对象。键值对将作为对象中的属性和值。

手写示例

以下是一个手写的 express.urlencoded 中间件示例：

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

app.use(express.urlencoded({ extended: true }));

app.post('/submit-form', (req, res) => {
  console.log(req.body); // 输出解析后的表单数据
  res.send('Form data received');
});