Joi JavaScript (Node.js) गाइड: उदाहरण, तरीके, इंस्टॉलेशन

Joi का परिचय: यह क्या है और क्यों ज़रूरी है

Joi, JavaScript (Node.js) वातावरण में डेटा वैलिडेशन के लिए एक शक्तिशाली लाइब्रेरी है। यह एक सरल और अभिव्यंजक API के माध्यम से डेटा स्कीमा को परिभाषित करने और वास्तविक ऑब्जेक्ट्स को इन स्कीमा से मिलाने की अनुमति देता है। Joi विशेष रूप से वेब एप्लिकेशन के सर्वर-साइड डेवलपमेंट में लोकप्रिय है, जहाँ इनकमिंग रिक्वेस्ट, कॉन्फ़िगरेशन, फॉर्म डेटा और अन्य डेटा संरचनाओं की जाँच करना आवश्यक होता है।

Joi का उपयोग करने के मुख्य कारण:

• सुरक्षा: आपके एप्लिकेशन में गलत या हानिकारक डेटा को आने से रोकता है
• कोड की पठनीयता: Joi स्कीमा को पढ़ना और समझना आसान है
• लचीलापन: जटिल नेस्टेड संरचनाओं, सशर्त वैलिडेशन और कस्टम नियमों का समर्थन करता है
• एकीकरण: Express, Koa, Fastify और अन्य फ्रेमवर्क के साथ बेहतरीन काम करता है
• विस्तृत त्रुटियाँ: समस्या के सटीक स्थान के साथ स्पष्ट त्रुटि संदेश प्रदान करता है

Joi की स्थापना (इंस्टॉलेशन)

Node.js प्रोजेक्ट में Joi को npm या yarn के माध्यम से स्थापित करें:

# npm के माध्यम से
npm install joi

# yarn के माध्यम से
yarn add joi

# यदि आप TypeScript का उपयोग करते हैं, तो टाइप्स स्थापित करें (वैकल्पिक)
npm install @types/joi --save-dev

स्थापना के बाद, आप अपने प्रोजेक्ट में Joi को इम्पोर्ट कर सकते हैं:

const Joi = require('joi');
// या ES मॉड्यूल के लिए:
// import Joi from 'joi';

त्वरित शुरुआत: पहला वैलिडेशन उदाहरण

आइए उपयोगकर्ता डेटा के वैलिडेशन के लिए एक सरल स्कीमा बनाएं और इसके काम की जाँच करें:

const Joi = require('joi');

// वैलिडेशन स्कीमा परिभाषित करें
const schema = Joi.object({
    username: Joi.string()
        .alphanum()
        .min(3)
        .max(30)
        .required(),
    password: Joi.string()
        .pattern(new RegExp('^[a-zA-Z0-9]{3,30}$')),
    email: Joi.string()
        .email({ minDomainSegments: 2, tlds: { allow: ['com', 'net'] } })
});

// जाँच के लिए डेटा
const userData = {
    username: 'john_doe',
    password: 'myPassword123',
    email: 'john@example.com'
};

// वैलिडेशन करें
const { error, value } = schema.validate(userData);

if (error) {
    console.log('वैलिडेशन त्रुटि:', error.details);
} else {
    console.log('डेटा मान्य है:', value);
}

इस उदाहरण में, हमने तीन फ़ील्ड वाले ऑब्जेक्ट के लिए एक स्कीमा बनाई। validate() मेथड दो गुणों वाला एक ऑब्जेक्ट लौटाता है: error (यदि त्रुटियाँ हैं) और value (मान्य डेटा)।

Joi के मुख्य तरीके

1. Joi.string() — स्ट्रिंग वैलिडेशन

यह क्या करता है: स्ट्रिंग मानों के लिए वैलिडेटर बनाता है। लंबाई, प्रारूप, सामग्री और अन्य स्ट्रिंग विशेषताओं की जाँच के लिए कई तरीके प्रदान करता है।

पैरामीटर: बिना पैरामीटर के। एक वैलिडेटर ऑब्जेक्ट लौटाता है, जिस पर मेथड चेन लगाई जा सकती है।

उदाहरण:

const schema = Joi.string()
    .min(3)           // न्यूनतम लंबाई 3 अक्षर
    .max(10)          // अधिकतम लंबाई 10 अक्षर
    .alphanum()       // केवल अक्षर और अंक
    .required();      // अनिवार्य फ़ील्ड

console.log(schema.validate('Hello'));    // { value: 'Hello' }
console.log(schema.validate('Hi'));       // { error: ... } - बहुत छोटी स्ट्रिंग
console.log(schema.validate('Hello123')); // { value: 'Hello123' }
console.log(schema.validate('Hello!'));   // { error: ... } - विशेष वर्ण शामिल हैं

2. Joi.number() — संख्या वैलिडेशन

यह क्या करता है: संख्यात्मक मानों के लिए वैलिडेटर बनाता है। सीमा, पूर्णांकता, सकारात्मकता और अन्य संख्या गुणों की जाँच करने की अनुमति देता है।

पैरामीटर: बिना पैरामीटर के। कॉन्फ़िगरेशन के लिए मेथड चेन का समर्थन करता है।

उदाहरण:

const schema = Joi.number()
    .integer()       // केवल पूर्णांक
    .min(0)