كمطورين، نحن نعلم أن التحقق من صحة النموذج هو جزء مهم من أي تطبيق. سواء كنت تقوم بإنشاء نموذج تسجيل بسيط أو نظام إدخال بيانات معقد، فإن ضمان دقة وسلامة إدخال المستخدم أمر ضروري. ومع ذلك، فإن تزويد المستخدمين بتعليقات مفيدة عند حدوث خطأ ما يمكن أن يكون بنفس القدر من الأهمية. وهنا يأتي دور "التصحيح الصحيح" – حزمة npm جديدة مصممة للارتقاء بالتحقق من صحة النموذج إلى المستوى التالي.

لماذا صحيح صحيح؟

صحيحة-صحيحة ليست مجرد مكتبة أخرى للتحقق من الصحة. لقد تم تصميمه مع التركيز بشكل فريد على معالجة الأخطاء وتصحيح المستخدم. بدلاً من مجرد إخبار المستخدمين بالأخطاء التي ارتكبوها، يقدم تطبيق valid-correct اقتراحات قابلة للتنفيذ حول كيفية تصحيح مدخلاتهم، مما يسهل عليهم القيام بذلك بشكل صحيح في المرة الأولى.

الميزات الرئيسية

قواعد التحقق الشاملة

تقدم مجموعة واسعة من طرق التحقق من الصحة، بدءًا من عمليات التحقق البسيطة مثل المطلوب والحد الأدنى والحد الأقصى إلى عمليات التحقق الأكثر تعقيدًا باستخدام التعبيرات العادية والوظائف المخصصة.

رسائل الخطأ التفصيلية

لا تتحقق كل قاعدة من قواعد التحقق من الامتثال فحسب، بل توفر أيضًا رسائل خطأ واضحة ومحددة. تساعد هذه الرسائل المستخدمين على فهم الخطأ الذي حدث بالضبط.

اقتراحات التصحيح

ما يميز الصحيح عن الصحيح هو ميزة اقتراح التصحيح. عند حدوث خطأ في التحقق من الصحة، تقدم الحزمة نصيحة عملية حول كيفية إصلاح المشكلة، وتوجيه المستخدمين نحو الإدخال الصحيح.

التكامل السهل

يعد دمج الصحيح والصحيح في تطبيق Node.js الحالي أمرًا سهلاً ومباشرًا. باستخدام بضعة أسطر فقط من التعليمات البرمجية، يمكنك البدء في استخدام أداة التحقق القوية هذه في النماذج الخاصة بك.

كيف تبدأ

إن البدء باستخدام الصحيح والصحيح أمر بسيط. أولاً، قم بتثبيت الحزمة باستخدام npm:

npm install valid-correct

بعد ذلك، حدد مخطط التحقق من الصحة الخاص بك. إليك مثال سريع:

const Validator = require('valid-correct');

const schema = {
    username: value => Validator.string(value).required().min(3).max(30),
    email: value => Validator.string(value).email().required(),
    password: value => Validator.string(value).required().min(8).pattern(/^[a-zA-Z0-9]{8,}$/, 'Password must be at least 8 characters long and alphanumeric.')
};

const userInput = {
    username: 'jsmith',
    email: '[email protected]',
    password: 'pass123'
};

const validationResult = Validator.validate(userInput, schema);

if (validationResult.isValid) {
    console.log('Validation successful!');
} else {
    console.log('Validation errors:', validationResult.errors);
}

في المثال أعلاه، قمنا بتحديد مخطط يتحقق من صحة اسم المستخدم والبريد الإلكتروني وكلمة المرور. إذا فشل أي من هذه الحقول في عمليات التحقق من الصحة، فسوف يعرض الخيار valid-correct رسائل خطأ مفصلة بالإضافة إلى اقتراحات التصحيح.

مثال على أخطاء التحقق من الصحة

لنفترض أن المستخدم أرسل الإدخال التالي:

{
    "username": "js",
    "email": "john.smith@com",
    "password": "pass"
}

قد يؤدي التصحيح الصحيح إلى إرجاع أخطاء التحقق التالية:

{
    "username": [
        {
            "message": "Minimum length is 3 characters.",
            "correction": "Please enter at least 3 characters. Current length is 2."
        }
    ],
    "email": [
        {
            "message": "Invalid email format.",
            "correction": "Please enter a valid email address (e.g., [email protected])."
        }
    ],
    "password": [
        {
            "message": "Password must be at least 8 characters long and alphanumeric.",
            "correction": "Please enter a valid password with at least 8 alphanumeric characters."
        }
    ]
}

كما ترون، يوفر الخيار valid-correct تعليمات واضحة حول ما يجب تصحيحه، مما يسهل على المستخدمين إرسال بيانات صالحة.

شارك!

نحن نؤمن بأن التصحيح الصحيح لديه القدرة على جعل التحقق من صحة النموذج أسهل وأكثر سهولة في الاستخدام للمطورين في كل مكان، ولكننا بحاجة لمساعدتكم لجعله أفضل! سواء كنت مساهمًا متمرسًا في المصادر المفتوحة أو بدأت للتو، فنحن نرغب في مشاركتك.

إليك كيفية المساهمة:

• الإبلاغ عن الأخطاء أو اقتراح ميزات جديدة عبر مشكلات GitHub الخاصة بنا.
• إرسال طلبات السحب مع التحسينات أو طرق التحقق الجديدة.
• انشر الكلمة من خلال مشاركة المعلومات الصحيحة مع شبكتك.

تفضل بزيارة مستودع GitHub الصحيح والصحيح لمعرفة المزيد والبدء.

الأفكار النهائية

لا يجب أن يكون التحقق من صحة النموذج عملاً روتينيًا. باستخدام "صحيح-صحيح"، يمكنك تبسيط العملية مع تزويد المستخدمين بالإرشادات التي يحتاجونها لتحقيق النجاح. جربه اليوم وأخبرنا برأيك!

شكرًا لدعمكم ومساهماتكم. معًا، يمكننا إنشاء أدوات تجعل التطوير أسهل وأكثر متعة للجميع.

ابدأ بالصحيح الصحيح اليوم: رابط حزمة npm.