Kurs NestJS · Moduł 10: Walidacja danych
Walidacja zagnieżdżona - Inspekcja głęboka
W tej lekcji5
Dotychczas walidowaliśmy proste, płaskie obiekty. Ale co jeśli przychodzące dane mają zagnieżdżone obiekty lub tablice obiektów? Potrzebujemy głębokiej inspekcji - strażnicy muszą sprawdzić nie tylko osobę na bramie, ale też jej bagaż, dokumenty w torbie i przedmioty w kieszeniach.
Problem - płaska walidacja nie wystarczy
Wyobraź sobie DTO dla legionu, który zawiera listę legionistów:
// BEZ zagnieżdżonej walidacji
export class CreateLegioDto {
@IsString()
name: string;
@IsArray()
soldiers: CreateSoldierDto[]; // Tablica obiektów
// Ale czy każdy obiekt w tablicy jest poprawny? NIE WIEMY!
}Samo @IsArray() sprawdzi tylko czy wartość jest tablicą - nie zwaliduje zawartości obiektów wewnątrz!
@ValidateNested() - strażnik zagnieżdżonych obiektów
Dekorator @ValidateNested() mówi class-validator: "Sprawdź też walidację obiektu wewnętrznego":
import { ValidateNested } from 'class-validator';
import { Type } from 'class-transformer';
class CreateSoldierDto {
@IsString()
@IsNotEmpty()
name: string;
@IsNumber()
@Min(16)
age: number;
}
export class CreateLegioDto {
@IsString()
@IsNotEmpty()
name: string;
@ValidateNested()
@Type(() => CreateSoldierDto)
commander: CreateSoldierDto;
}Ważne: @ValidateNested() zawsze wymaga @Type() z class-transformer! Bez niego NestJS nie wie, na jaką klasę skonwertować surowy obiekt.
Walidacja tablic zagnieżdżonych obiektów
Gdy masz tablicę obiektów, musisz dodać { each: true }:
export class CreateLegioDto {
@IsString()
name: string;
@ValidateNested({ each: true })
@Type(() => CreateSoldierDto)
soldiers: CreateSoldierDto[];
}Parametr { each: true } mówi dekoratorowi, żeby sprawdził każdy element tablicy osobno. Bez niego walidacja zagnieżdżona nie zadziała na tablicach.
Wielopoziomowe zagnieżdżenie
Zagnieżdżenie może sięgać wielu poziomów głębokości:
class WeaponDto {
@IsString()
@IsNotEmpty()
name: string;
@IsNumber()
@Min(1)
damage: number;
}
class SoldierDto {
@IsString()
@IsNotEmpty()
name: string;
@ValidateNested()
@Type(() => WeaponDto)
primaryWeapon: WeaponDto;
@IsOptional()
@ValidateNested()
@Type(() => WeaponDto)
secondaryWeapon?: WeaponDto;
}
class CohortDto {
@IsString()
name: string;
@ValidateNested({ each: true })
@Type(() => SoldierDto)
soldiers: SoldierDto[];
}
export class CreateLegioDto {
@IsString()
name: string;
@ValidateNested({ each: true })
@Type(() => CohortDto)
cohorts: CohortDto[];
}W tym przykładzie NestJS zwaliduje:
- Czy
CreateLegioDto.cohortsto tablica poprawnychCohortDto - Czy każdy
CohortDto.soldiersto tablica poprawnychSoldierDto - Czy każdy
SoldierDto.primaryWeaponto poprawnyWeaponDto
Komunikaty błędów zagnieżdżonych
Gdy walidacja zagnieżdżona nie przejdzie, NestJS zwróci szczegółowy błąd ze ścieżką do problematycznego pola:
// Przykładowa odpowiedź błędu:
{
"statusCode": 400,
"message": [
"cohorts.0.soldiers.1.name should not be empty",
"cohorts.0.soldiers.1.primaryWeapon.damage must be at least 1"
],
"error": "Bad Request"
}Głęboka inspekcja to kluczowa umiejętność strażników bramy. Bez niej złośliwy użytkownik mógłby przemycić niepoprawne dane w zagnieżdżonych obiektach!
Kod do tej lekcji: src/nested-validation.ts
// Walidacja zagnieżdżona - Głęboka inspekcja
import {
IsString,
IsNotEmpty,
IsNumber,
Min,
Max,
IsArray,
ArrayMinSize,
ValidateNested,
IsOptional,
IsEnum,
} from 'class-validator';
import { Type } from 'class-transformer';
// DTO broni
class WeaponDto {
@IsString()
@IsNotEmpty()
name: string;
@IsNumber()
@Min(1)
@Max(100)
damage: number;
}
// TODO: Uzupełnij DTO żołnierza z zagnieżdżoną walidacją
class SoldierDto {
@IsString()
@IsNotEmpty()
name: string;
@IsNumber()
@Min(16)
age: number;
// TODO: Dodaj @ValidateNested() i @Type(() => WeaponDto)
primaryWeapon: WeaponDto;
// TODO: Dodaj @IsOptional(), @ValidateNested(), @Type(() => WeaponDto)
secondaryWeapon?: WeaponDto;
}
// TODO: Uzupełnij DTO kohorty z tablicą zagnieżdżonych obiektów
class CohortDto {
@IsString()
@IsNotEmpty()
name: string;
// TODO: Dodaj @ValidateNested({ each: true })
// TODO: Dodaj @Type(() => SoldierDto)
// TODO: Dodaj @IsArray() i @ArrayMinSize(3)
soldiers: SoldierDto[];
}
console.log('Zagnieżdżona walidacja sprawdza obiekty w głąb!');
console.log('Pamiętaj: @ValidateNested wymaga @Type!');
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Co robi dekorator @ValidateNested() w class-validator?
2. Dlaczego @ValidateNested() wymaga użycia @Type() z class-transformer?
To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Uzupełnij dekoratory walidacji zagnieżdżonej w SoldierDto i CohortDto
- Układanie w pionie
Uporządkuj poziomy walidacji zagnieżdżonej od zewnętrznego do wewnętrznego:
- Klikanie w kolejności
Ułóż dekoratory pola soldiers w CreateLegioDto w prawidłowej kolejności: