🚀 توثيق مصمّم بواسطة Sonicar Tech LLC — احصل على توثيق منتجك خلال أسبوع ←
توثيق Class Validator من Sonicar.Tech
الخطوات الأولى

الاستخدام الأساسي

اعمل class بـ decorators خاصة بالـ validation، وبعدين تحقق من الـ instances باستخدام validate() أو validateSync()، وخيارات الـ validation زي whitelist.

عمل Class فيه Validation

عشان تبدأ تستخدم class-validator، أول حاجة اعمل class وحط عليه decorators الـ validation:

import { Length, IsEmail, Min } from 'class-validator';

export class User {
    @Length(4, 20)
    username: string;

    @IsEmail()
    email: string;

    @Min(18)
    age: number;
}

عمل Validation على Object

لما يبقى عندك class فيه decorators، تقدر تعمل validate لأي instance منه:

import { validate } from 'class-validator';

let user = new User();
user.username = "Sh"; // قصير جدًا
user.email = "invalid-email"; // مش إيميل صحيح
user.age = 16; // أصغر من 18

validate(user).then(errors => {
    if (errors.length > 0) {
        console.log('Validation failed:', errors);
    } else {
        console.log('Validation successful');
    }
});

خيارات الـ Validation

تقدر تمرر options لدالة validate:

validate(user, {
    skipMissingProperties: true, // تجاهل الـ properties اللي مش موجودة
    whitelist: true, // امسح أي property مالوش decorator
    forbidNonWhitelisted: true // ارمي error لو فيه properties مش مسموح بيها
});

Validation بشكل متزامن (Synchronous)

لو مش محتاج async validation، تقدر تستخدم validateSync:

import { validateSync } from 'class-validator';

const errors = validateSync(user);
if (errors.length > 0) {
    console.log('Validation failed:', errors);
} else {
    console.log('Validation successful');
}

🚀 محتاج توثيق زي ده لمنتجك؟

هذا الموقع بناه فريق Sonicar Tech LLC — بنساعد شركات SaaS وB2B والمؤسسات وFinTech وAI تطلق توثيق احترافي بأسلوب docs-as-code أسرع بـ 60% وأرخص، وأول نسخة جاهزة خلال أسبوع.

زيارة sonicar.tech ←

في هذه الصفحة