Kurs NestJS · Moduł 10: Walidacja danych

class-validator - Dekoratory strażników bramy

2 min czytania ·
W tej lekcji4

Teraz, gdy wiesz czym jest walidacja, czas poznać class-validator - bibliotekę dekoratorów, która zamienia zwykłe klasy DTO w prawdziwe posterunki strażnicze. Każdy dekorator to jak osobny strażnik specjalizujący się w konkretnym sprawdzeniu.

Instalacja

npm install class-validator class-transformer

Podstawowe dekoratory

@IsString() - strażnik tekstu

Sprawdza, czy wartość jest łańcuchem znaków. To jak strażnik weryfikujący, czy dokument jest napisany na papyrusie, a nie na kamieniu:

import { IsString } from 'class-validator';

export class CreateLegionaryDto {
  @IsString()
  name: string;  // "Marcus", 12345
}

@IsNumber() - strażnik liczb

Weryfikuje, czy wartość jest liczbą:

import { IsNumber } from 'class-validator';

export class CreateLegionaryDto {
  @IsNumber()
  age: number;  // 25, "dwadzieścia pięć"
}

@IsEmail() - strażnik wiadomości

Sprawdza poprawność formatu adresu email:

import { IsEmail } from 'class-validator';

export class CreateLegionaryDto {
  @IsEmail()
  cursusPublicus: string;  // "marcus@roma.com", "marcus"
}

@IsNotEmpty() - strażnik pustych pól

Nie przepuści pustych wartości - każde pole musi mieć treść:

import { IsNotEmpty, IsString } from 'class-validator';

export class CreateLegionaryDto {
  @IsString()
  @IsNotEmpty()
  name: string;  // "Marcus", "", null
}

@MinLength() i @MaxLength() - strażnicy długości

Kontrolują minimalną i maksymalną długość tekstu:

import { MinLength, MaxLength, IsString } from 'class-validator';

export class CreateLegionaryDto {
  @IsString()
  @MinLength(2)
  @MaxLength(50)
  name: string;  // "Marcus", "M", "A".repeat(51)
}

Łączenie dekoratorów

Prawdziwa siła class-validator tkwi w łączeniu wielu dekoratorów na jednym polu. To jak kilku strażników sprawdzających różne aspekty jednego dokumentu:

import {
  IsString,
  IsNotEmpty,
  MinLength,
  MaxLength,
  IsNumber,
  IsEmail,
  Min,
  Max,
} from 'class-validator';

export class CreateLegionaryDto {
  @IsString()
  @IsNotEmpty()
  @MinLength(2)
  @MaxLength(50)
  name: string;

  @IsString()
  @IsNotEmpty()
  rank: string;

  @IsNumber()
  @Min(16)
  @Max(65)
  age: number;

  @IsEmail()
  cursusPublicus: string;

  @IsString()
  @IsNotEmpty()
  legio: string;
}

Własne komunikaty błędów

Każdy dekorator przyjmuje opcjonalny parametr z komunikatem błędu - żeby strażnik umiał wytłumaczyć, co jest nie tak:

export class CreateLegionaryDto {
  @IsString({ message: 'Imię musi być tekstem, legioniście!' })
  @IsNotEmpty({ message: 'Imię nie może być puste!' })
  @MinLength(2, { message: 'Imię musi mieć co najmniej 2 znaki!' })
  name: string;

  @IsNumber({}, { message: 'Wiek musi być liczbą!' })
  @Min(16, { message: 'Musisz mieć co najmniej 16 lat, by wstąpić do legionu!' })
  age: number;
}

Dzięki class-validator tworzysz silną straż, która automatycznie odrzuca niepoprawne dane jeszcze zanim dotrą do logiki biznesowej. W następnej lekcji poznasz zaawansowane dekoratory!

Kod do tej lekcji: src/basic-decorators.ts
// class-validator - Podstawowe dekoratory strażników
import {
  IsString,
  IsNotEmpty,
  IsNumber,
  IsEmail,
  MinLength,
  MaxLength,
  Min,
  Max,
} from 'class-validator';

// DTO rekrutacyjny legionisty
export class CreateLegionaryDto {
  @IsString({ message: 'Imię musi być tekstem!' })
  @IsNotEmpty({ message: 'Imię nie może być puste!' })
  @MinLength(2, { message: 'Imię musi mieć min. 2 znaki!' })
  @MaxLength(50)
  name: string;

  @IsString()
  @IsNotEmpty()
  rank: string;

  @IsNumber({}, { message: 'Wiek musi być liczbą!' })
  @Min(16, { message: 'Minimum 16 lat do legionu!' })
  @Max(65)
  age: number;

  @IsEmail({}, { message: 'Niepoprawny email!' })
  cursusPublicus: string;
}

// TODO: Stwórz klasę CreateTributeDto z polami:
// - provinceName: string (wymagany, min 3 znaki)
// - amount: number (min 1, max 10000)
// - collectorEmail: string (musi być emailem)
// - description: string (opcjonalny, max 200 znaków)

export class CreateTributeDto {
  // Dodaj dekoratory walidacji tutaj
}

console.log('Dekoratory class-validator gotowe!');

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 @IsString() z biblioteki class-validator?

  2. 2. Jaki jest efekt użycia dekoratora @IsNotEmpty()?

To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

Zadania praktyczne w grze

  • Edytor kodu

    Uzupełnij brakujące dekoratory walidacji w klasie CreateMessengerDto

  • Układanie w pionie

    Ułóż dekoratory walidacji pola 'name' od najogólniejszego do najbardziej szczegółowego:

  • Edytor kodu

    Uzupełnij dekoratory własnymi komunikatami błędów w CreateTaxCollectorDto

  • Klikanie w kolejności

    Ułóż kroki instalacji i konfiguracji walidacji w NestJS:

  1. PytanieDekorator @IsString
  2. PytanieDekorator @IsNotEmpty
  3. Zadanie z kodemWalidacja email i długości tekstu
  4. Ułóż w kolejnościKolejność dekoratorów walidacji
  5. PytanieWłasne komunikaty błędów
  6. Zadanie z kodemWłasne komunikaty błędów walidacji
  7. Kliknij w kolejnościInstalacja narzędzi walidacji

Przydatne artykuły