JSON से TypeScript में परिवर्तक

कन्वर्टर JSON प्रकारों को TypeScript प्रकारों में निम्नलिखित तरीके से मैप करता है: JSON स्ट्रिंगें स्ट्रिंग में बदल जाती हैं; JSON संख्याएँ संख्या में बदल जाती हैं (टाइपस्क्रिप्ट में पूर्णांक-विशिष्ट प्रकारों की कमी के बारे में चेतावनी के साथ); JSON बूलियन मान बूलियन में बदल जाते हैं; JSON null मान आपकी कॉन्फ़िगरेशन के अनुसार null या undefined में बदल जाता है (null का अर्थ है कि मान null हो सकता है, अर्थात् इसे स्पष्ट रूप से सेट करना आवश्यक है, जबकि undefined का अर्थ है कि यह प्रॉपर्टी अनुपस्थित हो सकती है); JSON ऐरे Array<T> में बदल जाते हैं।या T[] जहाँ T निर्धारित आइटम प्रकार है (मिश्रित सरणियों में संघ प्रकारों का उपयोग किया जाता है); JSON ऑब्जेक्ट्स संदर्भ से उत्पन्न PascalCase नामों वाले नेस्टेड इंटरफ़ेस बन जाते हैं। कन्वर्टर निम्नलिखित भी पहचानता है: एनुम उम्मीदवार (ऐसे स्ट्रिंग फ़ील्ड जिनमें हमेशा एक ही मान सेट होता है, वे स्ट्रिंग लिटरल संघ प्रकार बन जाते हैं), रीडोनली उम्मीदवार (उन फ़ील्ड्स जो सभी नमूनों में अपरिवर्तित रहते हैं), और वैकल्पिक फ़ील्ड (केवल कुछ सरणी तत्वों में मौजूद गुण)।

इंटरफ़ेस एवं टाइप एलियास दोनों के अपने लाभ हैं। ऑब्जेक्ट-आकार के प्रकारों के लिए इंटरफ़ेस को प्राथमिकता दी जाती है क्योंकि: इसे विस्तारित किया जा सकता है (विरासत के लिए 'extends' कीवर्ड का उपयोग करें), यह घोषणाओं के संयोजन का समर्थन करता है (मौजूदा प्रकारों में विस्तार करते समय उपयोगी), अधिकांश कंपाइलरों में स्पष्ट त्रुटि संदेश प्रदान करता है, एवं API डेटा आकृतियों के लिए पारंपरिक विकल्प है। जब आपको यूनियन प्रकार (A | B), इंटरसेक्शन प्रकार (A & B), मैप्ड प्रकार, सशर्त प्रकार, या प्रिमिटिव्स एवं टुपल्स का नामकरण करने की आवश्यकता होती है, तो टाइप एलियास (type) को प्राथमिकता दी जाती है।API डेटा मॉडलिंग (सबसे सामान्य उपयोग मामला) के लिए, इंटरफ़ेस आमतौर पर बेहतर विकल्प होता है, क्योंकि API प्रतिक्रिया आकार आमतौर पर ऐसे ऑब्जेक्ट प्रकार होते हैं जो विस्तार क्षमताओं से लाभान्वित होते हैं। हालाँकि, यदि आप अपने उत्पन्न प्रकारों को यूनियन या सशर्त प्रकारों के साथ संयोजित करने की योजना बना रहे हैं, तो प्रकार एलियास अधिक लचीले हो सकते हैं। कनवर्टर आपकी पसंद के अनुसार कोई भी रूप उत्पन्न कर सकता है।

कन्वर्टर JSON नमूना डेटा के आधार पर वैकल्पिक (अनुपस्थित हो सकता है) और नलेबल (उपस्थित है लेकिन शून्य हो सकता है) के बीच अंतर का उपयोग करता है। यदि कोई गुण आपके नमूना सरणी में कुछ ऑब्जेक्ट्स में मौजूद है लेकिन अन्य में नहीं, तो TypeScript में इसे ? मॉडिफायर के साथ वैकल्पिक (optional) चिह्नित किया जाता है (address?: string)। यदि कोई गुण कभी-कभी शून्य (null) हो सकता है, तो इसका प्रकार null के साथ यूनियन (union) बन जाता है (address?: string | null)। यदि कोई गुण वैकल्पिक रूप से मौजूद है एवं मौजूद होने पर शून्य (null) भी हो सकता है, तो इसका प्रकार address?: string | null हो जाता है।tsconfig.json में कठोर शून्य जाँचों (null checks) का उपयोग करने वाली परियोजनाओं के लिए (जिसकी अत्यधिक सिफारिश की जाती है), ये अंतर अत्यंत महत्वपूर्ण हैं: वैकल्पिक गुणों की जाँच if (obj.address) या वैकल्पिक चेनिंग (obj.address?.city) के साथ की जानी चाहिए, जबकि गैर-वैकल्पिक लेकिन शून्य-संभावित गुणों की जाँच तब भी की जानी चाहिए जब वह गुण ऑब्जेक्ट में निश्चित रूप से मौजूद हो।

हाँ, रूपांतरक को भिन्नताओं का पता लगाने में मदद करने के लिए आप एक सरणी में कई JSON ऑब्जेक्ट्स को पेस्ट कर सकते हैं। जब आप कई नमूने प्रदान करते हैं: सभी ऑब्जेक्ट्स में मौजूद गुणों को आवश्यक के रूप में चिह्नित किया जाता है; केवल कुछ ऑब्जेक्ट्स में मौजूद गुणों को ? के साथ वैकल्पिक के रूप में चिह्नित किया जाता है; विभिन्न नमूनों में अलग-अलग प्रकार वाले गुणों को यूनियन प्रकारों के रूप में चिह्नित किया जाता है; और सरणी के आइटमों के प्रकार का निर्धारण केवल एक नमूने के बजाय सभी नमूनों में मौजूद सभी आइटमों से किया जाता है।उदाहरण के लिए, एक नमूने {name: string, age: number} के साथ आपको सभी आवश्यक फ़ील्ड मिलते हैं; जबकि दो नमूनों में से एक में {name: string, email: string} और दूसरे में {name: string, phone: string} होता है, तो कन्वर्टर निम्नलिखित परिणाम देता है: name: string (आवश्यक), email?: string (वैकल्पिक), phone?: string (वैकल्पिक)। यह विशेष रूप से उन API के लिए उपयोगी है जहाँ विभिन्न एंडपॉइंट्स या प्रतिक्रिया स्थितियाँ फ़ील्ड्स के अलग-अलग उपसमुच्चय लौटाती हैं।

उत्पन्न प्रकारों का उपयोग HTTP क्लाइंट लाइब्रेरियों में प्रकार-सुरक्षित API कॉल्स के लिए किया जा सकता है। fetch के साथ: प्रतिक्रिया प्रकार को परिभाषित करें और ApiResponseType के रूप में await response.json() का उपयोग करें।axios के साथ: generics जैसेaxios.get<ApiResponseType>(url) का उपयोग करें। React Query या SWR के साथ: प्रकार को hook useQuery<ApiResponseType>(key, fetcher) में पास करें। GraphQL कोडजन के साथ: उत्पन्न प्रकार आपके GraphQL स्कीमा प्रकारों के लिए आधार के रूप में कार्य कर सकते हैं।अपनी परियोजना में टाइप्स कॉपी करने के बाद आपको निम्नलिखित लाभ मिलते हैं: यदि आप API प्रतिक्रियाओं पर अस्तित्वहीन गुणों तक पहुँचते हैं तो कंपाइल-समय त्रुटियाँ; सभी प्रतिक्रिया फील्डों के लिए IDE ऑटोकम्प्लीशन (इनलाइन दस्तावेज़ीकरण के साथ); टाइप-सुरक्षित रीफैक्टरिंग (एक बार फील्ड का नाम बदलने पर सभी उपयोग अपडेट हो जाते हैं); और वास्तविक API संरचना के अनुरूप विश्वास। याद रखें कि जब API में परिवर्तन होता है तो अपने टाइप्स को अपडेट करें — कन्वर्टर इसे त्वरित ढंग से कर देता है, केवल नवीनतम JSON नमूना पेस्ट करके।