Pipes adalah kelas yang mentransformasi atau memvalidasi data input sebelum mencapai route handler. Mereka beroperasi pada argumen dari controller methods — baik mentransformasi mereka (misalnya string → number) maupun memvalidasi mereka (menolak data yang tidak valid). Validasi di NestJS dibangun di atas pipes.
()
() {
..(id);
}
Transformation pipes mengkonversi input ke tipe yang benar (route params/query selalu berupa string), gagal dengan 400 jika konversi tidak mungkin.
// 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
}
The ValidationPipe membaca class-validator decorators dari DTO dan memvalidasi data yang masuk secara otomatis — mengembalikan detailed 400 error saat gagal, sehingga handler Anda hanya menerima data yang valid.
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) ...
Anda mengimplementasikan method transform() dari PipeTransform untuk custom validation/transformation logic.
@UsePipes(new ValidationPipe()) // method or controller level
@Param("id", ParseIntPipe) // parameter level
app.useGlobalPipes(new ValidationPipe()) // global (most common for validation)
Pipes adalah fitur NestJS kunci untuk menangani input dengan aman, dan mereka adalah fondasi dari validation system framework. Memahami mereka penting karena hampir setiap API endpoint perlu memvalidasi dan mentransformasi input: transformation pipes (ParseIntPipe, dll.) memastikan parameters memiliki tipe yang benar, dan — yang paling penting — ValidationPipe dikombinasikan dengan DTOs menyediakan automatic, declarative validation dari request bodies terhadap class-validator rules, menolak invalid atau malicious input dengan clear errors sebelum mencapai business logic Anda.
Ini sangat penting untuk keamanan (validasi/sanitasi untrusted input, menghapus unexpected properties) dan robustness (handlers hanya menerima valid data).
Mengetahui cara mengaktifkan global validation pipe dengan opsi yang masuk akal (whitelist, transform), menggunakan built-in transformation pipes, dan menulis custom pipes adalah fundamental untuk membangun safe, well-structured NestJS APIs — pipes dan validation adalah everyday, must-know concepts dalam framework ini.