Pipe คืออะไรและ validation ทำงานอย่างไร?

Question

Accepted Answer

**Pipe** คือคลาสที่ **แปลงหรือ validate** ข้อมูล input ก่อนที่มันจะถึง route handler มันทำงานกับ argument ของ method ใน controller — ไม่ว่าจะแปลงพวกมัน (เช่น string → number) หรือ validate (ปฏิเสธข้อมูลที่ไม่ถูกต้อง) Validation ใน NestJS สร้างขึ้นบน pipe

## Transformation pipe ในตัว

```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
```

Transformation pipe แปลง input ให้เป็นชนิดที่ถูกต้อง (route param/query เป็น string เสมอ) โดยล้มเหลวด้วย 400 หากแปลงไม่ได้

## ValidationPipe — validate DTO อัตโนมัติ

```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` อ่าน decorator ของ `class-validator` ใน DTO และ validate ข้อมูลที่เข้ามาโดยอัตโนมัติ — ส่ง error 400 พร้อมรายละเอียดเมื่อล้มเหลว ดังนั้น handler ของคุณจะได้รับเฉพาะข้อมูลที่ถูกต้องเท่านั้น

## Pipe อยู่ตรงไหนในขั้นตอนของ request

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

## Custom pipe

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

คุณ implement method `transform()` ของ `PipeTransform` เพื่อสร้าง logic การ validate/transform ที่กำหนดเอง

## การใช้ pipe ในระดับต่าง ๆ

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

## ทำไมจึงสำคัญ

Pipe เป็นฟีเจอร์สำคัญของ NestJS สำหรับจัดการ input อย่างปลอดภัย และเป็นรากฐานของ **ระบบ validation** ของเฟรมเวิร์ก

การเข้าใจมันเป็นสิ่งจำเป็นเพราะแทบทุก API endpoint ต้อง validate และแปลง input: transformation pipe (`ParseIntPipe` ฯลฯ) ทำให้แน่ใจว่าพารามิเตอร์เป็นชนิดที่ถูกต้อง และ — ที่สำคัญที่สุด — **`ValidationPipe`** ที่รวมกับ DTO ให้การ validate request body แบบ declarative อัตโนมัติเทียบกับกฎของ `class-validator` โดยปฏิเสธ input ที่ไม่ถูกต้องหรือมุ่งร้ายพร้อม error ที่ชัดเจน *ก่อน* ที่มันจะถึง business logic ของคุณ

สิ่งนี้สำคัญทั้งต่อความปลอดภัย (validate/sanitize input ที่ไม่น่าเชื่อถือ, ตัด property ที่ไม่คาดหวังทิ้ง) และความทนทาน (handler รับเฉพาะข้อมูลที่ถูกต้อง)

การรู้วิธีเปิดใช้ global validation pipe พร้อมตัวเลือกที่เหมาะสม (`whitelist`, `transform`), ใช้ transformation pipe ในตัว และเขียน custom pipe เป็นพื้นฐานของการสร้าง API NestJS ที่ปลอดภัยและมีโครงสร้างดี — pipe และ validation เป็นแนวคิดที่ต้องรู้และใช้ทุกวันในเฟรมเวิร์ก