Pipes ਉਹ classes ਹਨ ਜੋ input data ਨੂੰ transform ਜਾਂ validate ਕਰਦੀਆਂ ਹਨ ਇਸ ਤੋਂ ਪਹਿਲਾਂ ਕਿ ਇਹ route handler ਤੱਕ ਪਹੁੰਚੇ। ਉਹ controller methods ਦੀਆਂ arguments ਤੇ ਕੰਮ ਕਰਦੀਆਂ ਹਨ — ਉਹਨਾਂ ਨੂੰ transform ਕਰਕੇ (ਜਿਵੇਂ string → number) ਜਾਂ ਉਹਨਾਂ ਨੂੰ validate ਕਰਕੇ (invalid data ਨੂੰ reject ਕਰਕੇ)। NestJS ਵਿੱਚ validation pipes ਦੇ ਅੰਤ ਉੱਤੇ ਲਾਗੂ ਹੈ।
()
() {
..(id);
}
Transformation pipes input ਨੂੰ ਸਹੀ type ਵਿੱਚ convert ਕਰਦੀਆਂ ਹਨ (route params/query ਹਮੇਸ਼ਾ strings ਹੁੰਦੇ ਹਨ), ਅਤੇ conversion ਸੰਭਵ ਨਾ ਹੋ ਤਾਂ 400 ਦੇ ਨਾਲ ਫੇਲ ਹੋ ਜਾਂਦੀ ਹੈ।
// 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
}
ValidationPipe DTO ਦੇ class-validator decorators ਨੂੰ ਪੜ੍ਹਦਾ ਹੈ ਅਤੇ incoming data ਨੂੰ automatically validate ਕਰਦਾ ਹੈ — failure ਤੇ detailed 400 error return ਕਰਦਾ ਹੈ, ਇਸ ਲਈ ਤੁਹਾਡਾ handler ਹਮੇਸ਼ਾ valid data ਹੀ ਪਾਉਂਦਾ ਹੈ।
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) ...
ਤੁਸੀਂ custom validation/transformation logic ਲਈ PipeTransform ਦੇ transform() method ਨੂੰ implement ਕਰਦੇ ਹੋ।
@UsePipes(new ValidationPipe()) // method or controller level
@Param("id", ParseIntPipe) // parameter level
app.useGlobalPipes(new ValidationPipe()) // global (most common for validation)
Pipes NestJS ਦੀ ਇੱਕ key feature ਹੈ input ਨੂੰ safely handle ਕਰਨ ਲਈ, ਅਤੇ ਉਹ framework ਦੀ validation system ਦੀ ਨੀਂਦ ਹਨ।
ਇਹ ਸਮਝਣਾ ਲਾਜ਼ਮੀ ਹੈ ਕਿਉਂਕਿ ਲਗਭਗ ਹਰ API endpoint ਨੂੰ input ਨੂੰ validate ਅਤੇ transform ਕਰਨਾ ਪੈਂਦਾ ਹੈ: transformation pipes (ParseIntPipe, ਆਦਿ) ਯਕੀਨੀ ਬਣਾਉਂਦੇ ਹਨ ਕਿ parameters ਸਹੀ type ਦੇ ਹਨ, ਅਤੇ — ਸਭ ਤੋਂ ਮਹੱਤਵਪੂਰਨ — ValidationPipe DTOs ਦੇ ਨਾਲ combined ਮਿਲ ਕੇ request bodies ਦੀ class-validator rules ਦੇ ਵਿਰੁੱਧ automatic, declarative validation ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ, invalid ਜਾਂ malicious input ਨੂੰ clear errors ਦੇ ਨਾਲ reject ਕਰਦਾ ਹੈ ਪਹਿਲਾਂ ਇਹ ਤੁਹਾਡੇ business logic ਤੱਕ ਪਹੁੰਚੇ।
ਇਹ security (untrusted input ਨੂੰ validate/sanitize ਕਰਕੇ, unexpected properties ਹਟਾਕੇ) ਅਤੇ robustness (handlers ਸਿਰਫ valid data ਪਾਉਂਦੇ ਹਨ) ਦੋਵਾਂ ਲਈ critical ਹੈ।
Global validation pipe ਨੂੰ sensible options (whitelist, transform) ਦੇ ਨਾਲ enable ਕਰਨਾ, built-in transformation pipes ਵਰਤਣਾ, ਅਤੇ custom pipes ਲਿਖਣਾ ਕਿਵੇਂ ਕਰਨਾ ਹੈ ਇਹ ਜਾਣਨਾ safe, well-structured NestJS APIs ਬਣਾਉਣ ਲਈ fundamental ਹੈ — pipes ਅਤੇ validation framework ਵਿੱਚ ਰੋਜ਼ਮਰਾਹ, must-know concepts ਹਨ।