Kurs NestJS · Moduł 10: Walidacja danych
class-validator - Dekoratory strażników bramy
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-transformerPodstawowe 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. Co robi dekorator @IsString() z biblioteki class-validator?
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: