Kurs NestJS · Moduł 10: Walidacja danych

Walidacja zagnieżdżona - Inspekcja głęboka

2 min czytania ·
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.cohorts to tablica poprawnych CohortDto
  • Czy każdy CohortDto.soldiers to tablica poprawnych SoldierDto
  • Czy każdy SoldierDto.primaryWeapon to poprawny WeaponDto

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. 1. Co robi dekorator @ValidateNested() w class-validator?

  2. 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:

  1. PytanieDekorator @ValidateNested
  2. PytanieWymaganie @Type z @ValidateNested
  3. Zadanie z kodemZagnieżdżona walidacja obiektów
  4. Ułóż w kolejnościGłębokość walidacji zagnieżdżonej
  5. PytanieWalidacja tablic zagnieżdżonych
  6. Kliknij w kolejnościBudowanie zagnieżdżonego DTO

Przydatne artykuły