Los Pipes son clases que transforman o validan datos de entrada antes de que lleguen a un controlador de ruta. Operan en los argumentos de los métodos del controlador — ya sea transformándolos (por ejemplo, string → number) o validándolos (rechazando datos inválidos). La validación en NestJS está construida sobre pipes.
()
() {
..(id);
}
Los pipes de transformación convierten la entrada al tipo correcto (los parámetros de ruta/query siempre son strings), fallando con un 400 si la conversión no es posible.
// enable globally in main.ts
app.useGlobalPipes(new ValidationPipe({
whitelist: true, // remove properties not declared in the DTO
forbidNonWhitelisted: true, // throw if unknown properties are present
transform: true, // turn plain objects into DTO instances, convert types
}));
// with a DTO using class-validator decorators:
export class CreateUserDto {
@IsEmail() email: string;
@MinLength(8) password: string;
}
@Post()
create(@Body() dto: CreateUserDto) { // ValidationPipe validates the body automatically
// if invalid → 400 with details, BEFORE this runs
}
El ValidationPipe lee los decoradores class-validator del DTO y valida automáticamente los datos entrantes — devolviendo un error 400 detallado en caso de fallo, para que tu controlador solo reciba datos válidos.
Request → ...middleware/guards/interceptors... → PIPES (transform/validate) → Handler
Pipes run JUST BEFORE the route handler, operating on its method arguments.
@Injectable()
export class TrimPipe implements PipeTransform {
transform(value: any) {
return typeof value === "string" ? value.trim() : value; // custom transformation
}
}
// usage: @Body(TrimPipe) ...
Implementas el método transform() de PipeTransform para lógica de validación/transformación personalizada.
@UsePipes(new ValidationPipe()) // method or controller level
@Param("id", ParseIntPipe) // parameter level
app.useGlobalPipes(new ValidationPipe()) // global (most common for validation)
Los Pipes son una característica clave de NestJS para manejar entrada de forma segura, y son la base del sistema de validación del framework.
Entenderlos es esencial porque casi todos los endpoints de API necesitan validar y transformar entrada: los pipes de transformación (ParseIntPipe, etc.) aseguran que los parámetros sean del tipo correcto, y — más importante aún — el ValidationPipe combinado con DTOs proporciona validación automática y declarativa de cuerpos de solicitud contra reglas de class-validator, rechazando entrada inválida o maliciosa con errores claros antes de que llegue a tu lógica de negocio.
Esto es crítico tanto para la seguridad (validar/sanitizar entrada no confiable, eliminar propiedades inesperadas) como para la robustez (los controladores solo reciben datos válidos).
Saber cómo habilitar el pipe de validación global con opciones sensatas (whitelist, transform), usar pipes de transformación incorporados y escribir pipes personalizados es fundamental para construir APIs NestJS seguras y bien estructuradas — los pipes y la validación son conceptos cotidianos y esenciales en el framework.