TypeScript, JavaScript का टाइप किया गया सुपरसेट है. इसे सामान्य Apps Script में कंपाइल किया जा सकता है. Apps Script प्रोजेक्ट को डेवलप करते समय TypeScript का इस्तेमाल करने पर, आपको ये फ़ायदे मिलते हैं:
- लोकल IDE में अपने-आप पूरा होने वाला कोड
- स्ट्रक्चरल टाइपिंग की सुविधा, जो ज़रूरी नहीं है
- टाइप इंफ़रेंस, इंटरफ़ेस
- ES6 की सुविधाएं, जैसे कि क्लास और ऐरो फ़ंक्शन.
इस गाइड में, TypeScript का इस्तेमाल करके Apps Script प्रोजेक्ट बनाने के कुछ सामान्य टास्क के बारे में बताया गया है.
ज़रूरी शर्तें
अगर आपको TypeScript के बारे में जानकारी नहीं है, तो इस गाइड में बताए गए किसी भी तरीके को आज़माने से पहले, TypeScript दस्तावेज़ और TypeScript क्विकस्टार्ट पढ़ें. इससे आपको बुनियादी कॉन्सेप्ट के बारे में जानकारी मिलेगी.
clasp वाले Apps Script प्रोजेक्ट में TypeScript का इस्तेमाल करने के लिए, यहां दिए गए टूल ज़रूरी हैं. Apps Script में TypeScript का इस्तेमाल करने के लिए, clasp का इस्तेमाल करना ज़रूरी नहीं है. हालांकि, इसका सुझाव दिया जाता है, क्योंकि इससे प्रोसेस को आसानी से पूरा किया जा सकता है.
यहां दी गई किसी भी प्रोसेस को आज़माने से पहले, पक्का करें कि आपने अपने लोकल डेवलपमेंट एनवायरमेंट को चालू करने के लिए, ये इंस्टॉल कर लिए हों:
- Node और npm
clasp:npm install -g @google/clasp- Apps Script के लिए टाइप की परिभाषाएं:
npm i -S @types/google-apps-script - Visual Studio Code (TypeScript IDE में अपने-आप पूरा होने की सुविधा के लिए)
अगर आपने पहले कभी clasp का इस्तेमाल नहीं किया है, तो clasp के दस्तावेज़ों के बारे में ज़रूर जानें
.
Clasp प्रोजेक्ट में TypeScript का इस्तेमाल करना
clasp का इस्तेमाल करके, तुरंत नया लोकल Apps Script प्रोजेक्ट बनाया जा सकता है.
यह निर्देश, appsscript.json और Code.gs बनाता है, जो Apps Script प्रोजेक्ट का आधार होता है.
किसी Apps Script फ़ाइल में TypeScript का इस्तेमाल करने के लिए, फ़ाइल एक्सटेंशन का नाम बदलकर
gs से ts करें.
स्थानीय TypeScript फ़ाइलों में बदलाव करना
अपने पसंदीदा एडिटर का इस्तेमाल करके, प्रोजेक्ट के फ़ोल्डर में .ts
फ़ाइलों के तौर पर, स्थानीय TypeScript फ़ाइलें लिखी जा सकती हैं.
उदाहरण के लिए, index.ts नाम की फ़ाइल में यह TypeScript कोड हो सकता है:
const greeter = (person: string) => {
return `Hello, ${person}!`;
}
let user = 'Grant';
Logger.log(greeter(user));
TypeScript में ES6+ की सुविधाओं का इस्तेमाल करके कोड लिखा जा सकता है. जैसे, ऐरो फ़ंक्शन और स्ट्रिंग इंटरपोलेशन (${var}). प्रोजेक्ट को Apps Script सर्वर पर पुश करने पर, इन फ़ाइलों को Apps Script कंस्ट्रक्ट में ट्रांसपाइल कर दिया जाता है.
TypeScript का इस्तेमाल करने वाला स्थानीय Apps Script प्रोजेक्ट अपलोड करना
लोकल TypeScript और Apps Script फ़ाइलों में बदलाव करने के बाद, यहां दिए गए clasp कमांड का इस्तेमाल करके, लोकल फ़ाइलों को Google Drive पर अपलोड किया जा सकता है:
clasp push --watch
यह निर्देश, TypeScript फ़ाइल में होने वाले बदलावों को मॉनिटर करता है. साथ ही, कोड को कंपाइल करने के लिए typescript और प्रोजेक्ट को Google Drive पर अपलोड करने के लिए clasp का इस्तेमाल करता है.
समस्याओं की शिकायत करना या सुविधा का अनुरोध करना
अगर आपको clasp टूल से जुड़ी कोई समस्या आती है, तो उसकी शिकायत GitHub पर की जा सकती है.
अगर आपको TypeScript में कोई समस्या या गड़बड़ी मिलती है, तो TypeScript के GitHub रिपॉज़िटरी में इसकी शिकायत की जा सकती है.