Express-Validator 7.0.0 使用介绍 - 功能强大、操作简单

Express-Validator：提升 Express.js 应用数据验证的利器

在 Express.js 应用开发中，数据验证是至关重要的。Express-Validator 是一个功能强大的验证器中间件，它提供了简洁直观的方式来验证和清理请求中的数据。

安装 Express-Validator

Express-Validator 可通过 npm 安装：

npm install express-validator

使用 Express-Validator

安装完成后，在 Express.js 应用中引入 Express-Validator：

const express = require('express');
const { body, validationResult } = require('express-validator');

const app = express();

然后，可以使用 Express-Validator 的验证器和清理器对数据进行验证和清理：

验证请求体

可以使用 body() 方法验证和清理请求体中的数据：

app.post('/user/create', [
  body('username').trim().notEmpty().withMessage('用户名不能为空'),
  body('password').trim().notEmpty().withMessage('密码不能为空'),
  body('email').trim().notEmpty().isEmail().withMessage('邮箱格式不正确')
], (req, res) => {
  const errors = validationResult(req);
  if (!errors.isEmpty()) {
    return res.status(400).json({ errors: errors.array() });
  }

  // 创建用户
  // ...
});

验证查询参数

可以使用 query() 方法验证和清理查询参数：

app.get('/user/list', [
  query('page').isInt().withMessage('页码必须为整数'),
  query('size').isInt().withMessage('每页数量必须为整数')
], (req, res) => {
  // ...
});

验证 header

可以使用 header() 方法验证和清理 header：

app.get('/user/profile', [
  header('Authorization').notEmpty().withMessage('Authorization header is required')
], (req, res) => {
  // ...
});

验证 cookie

可以使用 cookie() 方法验证和清理 cookie：

app.get('/user/session', [
  cookie('session_id').notEmpty().withMessage('Session ID cookie is required')
], (req, res) => {
  // ...
});

常见问题解答

1. 如何在多个中间件中使用 Express-Validator？

可以在中间件数组中使用 Express-Validator，例如：

app.use('/user', [
  express.json(),
  body('username').trim().notEmpty().withMessage('用户名不能为空'),
  body('password').trim().notEmpty().withMessage('密码不能为空'),
  // 其他中间件
]);

2. 如何自定义错误消息？

可以使用 withMessage() 方法自定义错误消息，例如：

body('username').trim().notEmpty().withMessage('用户名必填');

3. 如何获取验证错误？

可以使用 validationResult() 方法获取验证错误，例如：

const errors = validationResult(req);

4. 如何使用其他验证器？

Express-Validator 提供了广泛的验证器，包括 isInt(), isEmail(), isURL(), isBoolean() 等。

5. Express-Validator 支持什么类型的验证？

Express-Validator 支持以下类型的验证：

• 空值检查
• 类型检查
• 长度检查
• 正则表达式检查
• 自定义检查

结论

Express-Validator 是一个功能强大且易于使用的验证器中间件，可以帮助您轻松地在 Express.js 应用中验证和清理数据。通过其丰富的验证器和灵活的自定义选项，Express-Validator 可以满足各种数据验证需求。使用 Express-Validator 可以提高应用的健壮性和数据安全性，让您专注于业务逻辑。