Effect-ts TypeScript: पूर्ण गाइड उदाहरणों के साथ

Effect-ts क्या है और इसकी आवश्यकता क्यों है?

Effect-ts TypeScript के लिए एक शक्तिशाली लाइब्रेरी है जो फंक्शनल प्रोग्रामिंग की अवधारणाओं को भाषा में लाती है, जिससे आप स्वच्छ, कम्पोज़ेबल और टाइप-सेफ कोड लिख सकते हैं। यह TypeScript (और सामान्यतः JavaScript) डेवलपमेंट की एक मुख्य समस्या को हल करती है — साइड इफेक्ट्स (side effects) का प्रबंधन।

पारंपरिक इम्पेरेटिव प्रोग्रामिंग में, साइड इफेक्ट्स (नेटवर्क, फ़ाइलें, डेटाबेस, रैंडम नंबर जनरेशन, समय के साथ काम) कोड में बिखरे होते हैं, जिससे टेस्टिंग, डीबगिंग और विश्लेषण कठिन हो जाता है। Effect-ts एक सुंदर दृष्टिकोण प्रदान करता है: सभी साइड इफेक्ट्स को डेटा (मान) के रूप में वर्णित किया जाता है, जिसे जोड़ा, रूपांतरित और नियंत्रित वातावरण में निष्पादित किया जा सकता है।

Effect-ts के मुख्य लाभ:

• टाइप सुरक्षा: TypeScript कंपाइलर त्रुटियों और सफल परिणामों के प्रकारों को टाइप स्तर पर जांचता है।
• कम्पोज़ेबिलिटी: इफेक्ट्स को map, flatMap, zip और अन्य फंक्शन्स के साथ आसानी से जोड़ा जा सकता है।
• एरर हैंडलिंग: त्रुटियों को अपवादों के बजाय इफेक्ट के प्रकार के हिस्से के रूप में संभाला जाता है।
• टेस्टेबिलिटी: निर्भरताएं (जैसे HTTP क्लाइंट, डेटाबेस) आसानी से बदली जा सकती हैं।
• कंकरेंसी: एसिंक्रोनसिटी, समानांतरता और ऑपरेशन रद्द करने के लिए अंतर्निहित समर्थन।
• पूर्वानुमेयता: कोड अधिक डिक्लेरेटिव और समझने में आसान हो जाता है।

Effect-ts विशेष रूप से बड़े प्रोजेक्ट्स में उपयोगी है जहां विश्वसनीयता, टेस्टेबिलिटी और स्केलेबिलिटी महत्वपूर्ण है। इसका उपयोग बैकएंड डेवलपमेंट (Node.js), फ्रंटएंड (React) और मोबाइल एप्लिकेशन में भी किया जाता है।

इंस्टॉलेशन

अपने प्रोजेक्ट में Effect-ts इंस्टॉल करने के लिए npm या yarn का उपयोग करें:

npm install effect

या

yarn add effect

सुनिश्चित करें कि आपके पास TypeScript संस्करण 4.7 या उच्चतर स्थापित है:

npm install typescript --save-dev

Effect-ts के साथ काम करने के लिए, आपको tsconfig.json को कॉन्फ़िगर करना होगा, जिसमें सख्त मोड (strict: true) और अधिमानतः target: "ES2020" या उच्चतर शामिल हो।

कोड उदाहरण के साथ त्वरित शुरुआत

आइए एक सरल प्रोग्राम लिखें जो कमांड लाइन से उपयोगकर्ता का नाम पढ़ता है और अभिवादन प्रिंट करता है। यह Effect-ts की मूल अवधारणा दिखाएगा: इफेक्ट का वर्णन और उसका निष्पादन।

import { Effect, Console } from "effect"

// इफेक्ट का वर्णन: नाम मांगना
const askName: Effect.Effect<string> = Effect.sync(() => {
  // वास्तविक एप्लिकेशन में यहां कीबोर्ड इनपुट होगा
  return "राहुल"
})

// इफेक्ट का वर्णन: अभिवादन प्रिंट करना
const greet = (name: string): Effect.Effect<void> =>
  Console.log(`नमस्ते, ${name}!`)

// इफेक्ट्स को जोड़ना
const program: Effect.Effect<void> = askName.pipe(
  Effect.flatMap(greet)
)

// प्रोग्राम चलाना
Effect.runSync(program)
// आउटपुट: नमस्ते, राहुल!

इस उदाहरण में:

• Effect.sync — एक सिंक्रोनस फंक्शन से इफेक्ट बनाता है।
• Console.log — कंसोल में आउटपुट के लिए एक इफेक्ट है।
• pipe — मान पर क्रमिक रूप से फंक्शन लागू करने की अनुमति देता है।
• flatMap — इफेक्ट्स को क्रमिक रूप से निष्पादित करने के लिए उपयोग किया जाता है।
• Effect.runSync — इफेक्ट को सिंक्रोनस रूप से निष्पादित करता है (केवल सिंक्रोनस इफेक्ट्स के लिए)।

Effect-ts के मुख्य तरीके और फंक्शन

1. Effect.sync

क्या करता है: एक इफेक्ट बनाता है जो एक सिंक्रोनस फंक्शन को लपेटता है। फंक्शन लेज़ीली (केवल इफेक्ट चलने पर) निष्पादित होता है।

पैरामीटर:

• f: () => A — एक सिंक्रोनस फंक्शन जो A प्रकार का मान लौटाता है।

उदाहरण:

import { Effect } from "effect"

const getRandomInt: Effect.Effect<number> = Effect.sync(() => {
  retur