express-validator 命令式验证执行详解

express-validator 命令式验证执行详解

express-validator 项目地址: https://gitcode.com/gh_mirrors/exp/express-validator

什么是命令式验证

express-validator 库主要采用声明式的方式处理验证逻辑，这也是 Express 中间件的典型工作方式。但在某些特殊场景下，开发者可能需要更精细地控制验证流程的执行时机和方式，这时就可以使用命令式验证方法 run(req)。

run(req) 方法解析

run(req) 方法可用于验证链(validation chain)和净化链(sanitization chain)，它允许开发者手动触发验证流程。这个方法返回一个 Promise，当验证完成后会被解析。

核心特点

1. 灵活控制：可以决定何时执行验证
2. 条件验证：基于特定条件执行验证
3. 流程控制：可以并行或串行执行多个验证

典型应用场景

标准化错误响应处理

// 并行处理验证
const validate = validations => {
  return async (req, res, next) => {
    await Promise.all(validations.map(validation => validation.run(req)));
    
    const errors = validationResult(req);
    if (errors.isEmpty()) {
      return next();
    }

    res.status(400).json({ errors: errors.array() });
  };
};

// 串行处理验证（遇到错误立即停止）
const validate = validations => {
  return async (req, res, next) => {
    for (let validation of validations) {
      const result = await validation.run(req);
      if (result.errors.length) break;
    }

    const errors = validationResult(req);
    if (errors.isEmpty()) {
      return next();
    }

    res.status(400).json({ errors: errors.array() });
  }
};

使用示例：

app.post('/api/create-user', validate([
  body('email').isEmail(),
  body('password').isLength({ min: 6 })
]), async (req, res) => {
  // 确保请求没有验证错误
  const user = await User.create({ ... });
});

条件验证

app.post('/update-settings', [
  body('email').isEmail(),
  body('password').optional().isLength({ min: 6 })
], async (req, res) => {
  // 如果提供了密码，则必须提供确认密码
  if (req.body.password) {
    await body('passwordConfirmation')
      .equals(req.body.password).withMessage('密码不匹配')
      .run(req);
  }

  // 检查验证错误并更新用户设置
});

开发建议

1. 并行与串行的选择：

   • 并行处理适合独立无依赖的验证规则
   • 串行处理适合有依赖关系的验证规则

2. 错误处理：

   • 始终检查 validationResult 获取最终验证结果
   • 考虑统一错误响应格式

3. 性能考虑：

   • 避免不必要的重复验证
   • 复杂验证逻辑可以考虑拆分到多个中间件

命令式验证为开发者提供了更灵活的验证控制方式，特别适合需要条件验证或自定义验证流程的场景。合理使用可以构建出既健壮又灵活的验证系统。

express-validator 项目地址: https://gitcode.com/gh_mirrors/exp/express-validator