Apakah pipa (pipes) dan bagaimana cara validasi berfungsi?

Question

Accepted Answer

**Pipa (pipes)** adalah kelas yang **mengubah atau memvalidasi** data masukan sebelum mencapai penanganan rute (route handler). Mereka beroperasi pada argumen metode pengontrol — mengubahnya (misalnya string → number) atau memvalidasinya (menolak data tidak valid). Validasi di NestJS dibangun di atas pipa.

## Built-in transformation pipes

```ts
@Get(":id")
findOne(@Param("id", ParseIntPipe) id: number) {    // transforms "5" (string) → 5 (number)
  // id is guaranteed to be a number; non-numeric input → 400 error automatically
  return this.usersService.findOne(id);
}
// other built-ins: ParseBoolPipe, ParseUUIDPipe, ParseArrayPipe, DefaultValuePipe
```

Pipa transformasi mengonversi masukan ke tipe yang benar (parameter rute/kueri selalu string), gagal dengan 400 jika konversi tidak mungkin.

## The ValidationPipe — automatic DTO validation

```ts
// 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
}));
```

```ts
// 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
}
```

`ValidationPipe` membaca dekorator `class-validator` DTO dan memvalidasi data masuk secara otomatis — mengembalikan kesalahan 400 terperinci saat gagal, sehingga penanganan Anda hanya menerima data valid.

## How pipes fit in the request flow

```text
Request → ...middleware/guards/interceptors... → PIPES (transform/validate) → Handler
Pipes run JUST BEFORE the route handler, operating on its method arguments.
```

## Custom pipes

```ts
@Injectable()
export class TrimPipe implements PipeTransform {
  transform(value: any) {
    return typeof value === "string" ? value.trim() : value;   // custom transformation
  }
}
// usage: @Body(TrimPipe) ...
```

Anda mengimplementasikan metode `transform()` dari `PipeTransform` untuk logika validasi/transformasi khusus.

## Applying pipes at different levels

```ts
@UsePipes(new ValidationPipe())      // method or controller level
@Param("id", ParseIntPipe)            // parameter level
app.useGlobalPipes(new ValidationPipe())   // global (most common for validation)
```

## Mengapa ini penting

Pipa adalah fitur kunci NestJS untuk menangani masukan dengan aman, dan mereka adalah fondasi dari **sistem validasi** kerangka kerja.

Memahami mereka sangat penting karena hampir setiap titik akhir API perlu memvalidasi dan mengubah masukan: pipa transformasi (`ParseIntPipe`, dll.) memastikan parameter memiliki tipe yang benar, dan — yang paling penting — **`ValidationPipe`** digabungkan dengan DTO menyediakan validasi otomatis dan deklaratif dari badan permintaan terhadap aturan `class-validator`, menolak masukan tidak valid atau berbahaya dengan kesalahan jelas *sebelum* mencapai logika bisnis Anda.

Ini sangat penting baik untuk keamanan (memvalidasi/membersihkan masukan yang tidak terpercaya, menghapus properti yang tidak terduga) dan ketahanan (penanganan hanya menerima data valid).

Mengetahui cara mengaktifkan pipa validasi global dengan opsi yang masuk akal (`whitelist`, `transform`), menggunakan pipa transformasi bawaan, dan menulis pipa khusus adalah hal mendasar untuk membangun API NestJS yang aman dan terstruktur dengan baik — pipa dan validasi adalah konsep sehari-hari dan wajib diketahui di kerangka kerja.