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

الأسئلة الشائعة

إجابات عن أسئلة متكررة حول class-validator — الكائنات العادية مقابل نسخ الأصناف، whitelist، المدقّقات غير المتزامنة، المجموعات، ودعم المتصفح.

هل أقدر أعمل validation لـ object عادي بدل instance من class؟

مش مباشرة. class-validator بيقرأ الـ metadata اللي متحطة على decorators الـ class، فدالة validate() بتشتغل بس على instances حقيقية من classes — أي object عادي أو نتيجة JSON.parse() مافيهوش الـ metadata دي أصلًا. حوّله الأول باستخدام plainToInstance() من class-transformer، وبعدين اعمل validate للـ instance الناتج.

import { plainToInstance } from 'class-transformer';
import { validate } from 'class-validator';

const instance = plainToInstance(User, plainObject);
const errors = await validate(instance);

ليه whitelist: true بيمسح properties كنت عايز أحتفظ بيها؟

خيار whitelist بيمسح أي property مالوش أي decorator أصلًا — مش بس اللي بيفشل في الـ validation. لو الـ property مقصود إنه اختياري أو من غير فحص لكنك عايز تحتفظ بيه، حط عليه @Allow() بدل ما تسيبه من غير decorator. شوف صفحة الـ Whitelisting.

أقدر أستخدم class-validator من غير decorators، في JavaScript عادي؟

الـ decorators محتاجة TypeScript (أو Babel مع plugin الـ decorators) مع تفعيل experimentalDecorators. الـ validation اللي بيعتمد على schema من غير decorators كان موجود لفترة قصيرة بس اتشال من نسخة v0.12 ومش هيرجع تاني. للمشاريع اللي JavaScript بس، استخدم دوال is* المُصدَّرة يدويًا — شوف صفحة Validation يدوي.

ليه نتيجة الـ custom validator غير المتزامن بتاعي مش بتترصد؟

دالة validateSync() بتتجاهل كل الـ validators الغير متزامنة وتعتبرها ناجحة، بغض النظر عن نتيجتها الحقيقية. لو الـ ValidatorConstraint متعلّم بـ { async: true }، لازم تستخدم validate() (اللي بترجع Promise) بدل validateSync().

إزاي أعمل validation لكل عنصر في array؟

مرر each: true جوه options الـ decorator — زي @IsEmail({}, { each: true }) على property من نوع string[]. الـ decorator وقتها هيشتغل مرة لكل عنصر في الـ array بدل ما يشتغل مرة واحدة على الـ array كله. شوف صفحة عمل Validation على Arrays.

class-validator بتشتغل في المتصفح، ولا في Node.js بس؟

بتشتغل في الاتنين. validator.js، اللي class-validator بيستخدمه تحت الغطاء، مالوش أي dependencies خاصة بـ Node بس، فنفس الـ decorators ودالة validate() بتشتغل في كود متصفح مبني بـ bundler زي ما بتشتغل على السيرفر بالظبط.

إزاي أحوّل ValidationError لرسالة خطأ نصية بسيطة؟

كل ValidationError فيه object اسمه constraints، مفاتيحه هي أسماء الـ validators اللي فشلت (زي constraints.isEmail)، وقيمته هي نص الرسالة القابل للقراءة. اعمل flatten للنتيجة كده:

const messages = errors
  .map((e) => Object.values(e.constraints ?? {}))
  .flat();

أقدر أستخدم نفس الـ class لعمليتي create وupdate بقواعد مختلفة؟

أيوه، باستخدام validation groups. حط على الـ decorators المناسبة groups: ['create']، وبعدين مرر { groups: ['create'] } لدالة validate() عشان يشتغل بس الـ decorators اللي متعلّمة بالـ group ده. شوف صفحة Validation Groups.

الأسئلة الشائعة

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

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

زيارة sonicar.tech ←

في هذه الصفحة