TypeScript, JavaScript का टाइप किया गया सुपरसेट है. इसे Apps Script में कंपाइल किया जा सकता है. Apps Script प्रोजेक्ट को डेवलप करने के लिए TypeScript का इस्तेमाल करने पर, आपको ये फ़ायदे मिलते हैं:
- लोकल आईडीई में अपने-आप पूरा होने की सुविधा
- ज़रूरी नहीं स्ट्रक्चरल टाइपिंग
- टाइप इन्फ़रेंस, इंटरफ़ेस
- 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));
ES6+ की सुविधाओं के साथ TypeScript लिखी जा सकती है. जैसे, ऐरो फ़ंक्शन और स्ट्रिंग इंटरपोलेशन (${var}). जब प्रोजेक्ट को Apps Script सर्वर पर पुश किया जाता है, तब इन फ़ाइलों को Apps Script कंस्ट्रक्ट में ट्रांसपाइल किया जाता है.
TypeScript का इस्तेमाल करने वाले किसी लोकल Apps Script प्रोजेक्ट को अपलोड करना
TypeScript और Apps Script की लोकल फ़ाइलों में बदलाव करने के बाद, इन फ़ाइलों को Google Drive पर अपलोड किया जा सकता है. इसके लिए, clasp कमांड का इस्तेमाल करें:
clasp push --watch
यह कमांड, TypeScript फ़ाइल में हुए बदलावों पर नज़र रखती है. साथ ही, कोड को कंपाइल करने के लिए typescript और प्रोजेक्ट को Google Drive पर अपलोड करने के लिए clasp का इस्तेमाल करती है.
समस्याओं की शिकायत करना या सुविधा के लिए अनुरोध सबमिट करना
अगर आपको clasp टूल से जुड़ी कोई समस्या आती है, तो इसकी शिकायत GitHub पर की जा सकती है.
अगर आपको TypeScript में कोई समस्या या गड़बड़ी मिलती है, तो इसकी शिकायत TypeScript के GitHub रिपॉज़िटरी में की जा सकती है.