Что такое pipes и как работает валидация?

Question

Accepted Answer

**Pipes** — это классы, которые **трансформируют или валидируют** входные данные перед тем, как они попадут в обработчик маршрута. Они работают с аргументами методов контроллера — либо трансформируя их (например, строка → число), либо валидируя их (отклоняя недопустимые данные). Валидация в NestJS построена на pipes.

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

Pipes трансформации преобразуют входные данные в нужный тип (параметры маршрута/query всегда являются строками), возвращая 400, если преобразование невозможно.

## The ValidationPipe — автоматическая валидация 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` читает декораторы `class-validator` DTO и автоматически валидирует входящие данные — возвращая подробную ошибку 400 при сбое, поэтому ваш обработчик получает только валидные данные.

## Как pipes встраиваются в поток запроса

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

Вы реализуете метод `transform()` интерфейса `PipeTransform` для пользовательской логики валидации/трансформации.

## Применение pipes на разных уровнях

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

## Почему это важно

Pipes — это ключевая функция NestJS для безопасной обработки входных данных, и они являются основой **системы валидации** фреймворка.

Понимание их критически важно, потому что практически каждый endpoint API должен валидировать и трансформировать входные данные: pipes трансформации (`ParseIntPipe` и т. д.) гарантируют, что параметры имеют правильный тип, а — что самое главное — **`ValidationPipe`** в сочетании с DTO обеспечивают автоматическую декларативную валидацию тел запросов в соответствии с правилами `class-validator`, отклоняя неправильные или вредоносные данные с четкими ошибками *до* того, как они достигнут вашей бизнес-логики.

Это критично как для безопасности (валидация/очистка ненадежных входных данных, удаление неожиданных свойств), так и для надежности (обработчики получают только валидные данные).

Знание того, как включить глобальный pipe валидации с разумными параметрами (`whitelist`, `transform`), использовать встроенные pipes трансформации и писать пользовательские pipes, является фундаментальным для создания безопасных, хорошо структурированных NestJS API — pipes и валидация — это повседневные, обязательные концепции в фреймворке.