Pipes er klasser, der transformerer eller validerer inputdata, før det når en route handler. De fungerer på argumenterne fra controller-metoder — enten ved at transformere dem (f.eks. string → number) eller validere dem (afvise ugyldige data). Validering i NestJS er bygget på pipes.
()
() {
..(id);
}
Transformations-pipes konverterer input til den rigtige type (ruteparametre/queries er altid strenge), og mislykkes med 400, hvis konvertering ikke er mulig.
// 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
}
ValidationPipe læser DTO'ens class-validator-dekoratører og validerer indgående data automatisk — returnerer en detaljeret 400-fejl ved fejl, så din handler kun modtager gyldige 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) ...
Du implementerer PipeTransform's transform()-metode til brugerdefineret validerings-/transformationslogik.
@UsePipes(new ValidationPipe()) // method or controller level
@Param("id", ParseIntPipe) // parameter level
app.useGlobalPipes(new ValidationPipe()) // global (most common for validation)
Pipes er en vigtig NestJS-funktion til sikker håndtering af input, og de er grundlaget for frameworkets valideringssystem.
At forstå dem er afgørende, fordi næsten hvert API-endpoint skal validere og transformere input: transformations-pipes (ParseIntPipe osv.) sikrer, at parametre er den korrekte type, og — vigtigst af alt — ValidationPipe kombineret med DTO'er giver automatisk, deklarativ validering af request bodies mod class-validator-regler, afviser ugyldige eller ondsindet input med klare fejl før det når din forretningslogik.
Dette er kritisk både for sikkerhed (validering/sanitering af upalideligt input, fjernelse af uventede egenskaber) og robusthed (handlers modtager kun gyldige data).
At vide, hvordan du aktiverer det globale validerings-pipe med fornuftige indstillinger (whitelist, transform), bruger indbyggede transformations-pipes og skriver brugerdefinerede pipes, er grundlæggende for at bygge sikre, velstrukturerede NestJS API'er — pipes og validering er daglige, vigtige begreber i frameworket.