Pipes sind Klassen, die Eingabedaten transformieren oder validieren, bevor sie einen Route Handler erreichen. Sie operieren auf den Argumenten von Controller-Methoden — entweder durch Transformation (z. B. string → number) oder Validierung (Ablehnung ungültiger Daten). Validierung in NestJS basiert auf Pipes.
()
() {
..(id);
}
Transformation Pipes konvertieren Eingaben in den richtigen Typ (Route-Parameter/Query sind immer Strings), scheitern mit 400, wenn die Konvertierung nicht möglich ist.
// 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
}
Die ValidationPipe liest die class-validator-Dekoratoren des DTO und validiert eingehende Daten automatisch — gibt bei Fehlern einen detaillierten 400-Fehler zurück, damit Ihr Handler nur gültige Daten erhält.
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) ...
Sie implementieren die transform()-Methode von PipeTransform für benutzerdefinierte Validierungs-/Transformationslogik.
@UsePipes(new ValidationPipe()) // method or controller level
@Param("id", ParseIntPipe) // parameter level
app.useGlobalPipes(new ValidationPipe()) // global (most common for validation)
Pipes sind eine Schlüsselfunktion von NestJS für die sichere Eingabeverarbeitung und bilden die Grundlage des Validierungssystems des Frameworks.
Das Verständnis ist essentiell, da nahezu jeder API-Endpoint Eingaben validieren und transformieren muss: Transformation Pipes (ParseIntPipe usw.) stellen sicher, dass Parameter vom richtigen Typ sind, und — am wichtigsten — ValidationPipe kombiniert mit DTOs bietet automatische, deklarative Validierung von Request Bodies gegen class-validator-Regeln, lehnt ungültige oder böswillige Eingaben mit klaren Fehlern ab, bevor sie Ihre Geschäftslogik erreichen.
Dies ist entscheidend sowohl für die Sicherheit (Validierung/Bereinigung von nicht vertrauenswürdigen Eingaben, Entfernung unerwarteter Eigenschaften) als auch für die Robustheit (Handler erhalten nur gültige Daten).
Das Wissen über die Aktivierung des globalen Validierungs-Pipes mit vernünftigen Optionen (whitelist, transform), die Verwendung von integrierten Transformation Pipes und das Schreiben von benutzerdefinierten Pipes ist grundlegend für den Aufbau sicherer, gut strukturierter NestJS APIs — Pipes und Validierung sind alltägliche, unerlässliche Konzepte im Framework.
Eine Sammlung von IT-Interviewfragen mit ausführlichen Antworten — vom Junior bis zum Senior.
Spenden