TypeScript adalah superset type dari JavaScript yang dapat dikompilasi menjadi Apps Script biasa. Saat menggunakan TypeScript dalam pengembangan project Apps Script, Anda akan mendapatkan manfaat berikut:
- Penyelesaian otomatis IDE lokal
- Pengetikan struktural opsional
- Inferensi jenis, antarmuka
- Fitur ES6 seperti class dan fungsi panah.
Panduan ini mencakup beberapa tugas umum untuk mengembangkan project Apps Script dengan TypeScript.
Persyaratan
Jika Anda belum terbiasa dengan TypeScript, tinjau dokumentasi TypeScript dan TypeScript quickstart untuk memahami konsep dasarnya sebelum mencoba salah satu prosedur yang dijelaskan dalam panduan ini.
Alat berikut diperlukan untuk menggunakan TypeScript di project Apps Script dengan clasp. Meskipun penggunaan clasp tidak
benar-benar diperlukan untuk mengaktifkan penggunaan TypeScript di Apps Script, penggunaan ini sangat
direkomendasikan karena sangat menyederhanakan prosedur.
Sebelum mencoba salah satu proses yang dijelaskan di bawah, pastikan Anda telah menginstal hal berikut untuk mengaktifkan lingkungan pengembangan lokal Anda:
- Node dan npm
clasp:npm install -g @google/clasp- Definisi jenis untuk Apps Script:
npm i -S @types/google-apps-script - Visual Studio Code (untuk penyelesaian otomatis IDE TypeScript)
Pastikan Anda memahami dokumentasi clasp
jika Anda belum pernah menggunakan clasp sebelumnya.
Menggunakan TypeScript dalam Project Clasp
Anda dapat menggunakan clasp untuk
membuat project Apps Script lokal baru dengan cepat.
Perintah ini membuat appsscript.json dan Code.gs, dasar project Apps
Script.
Untuk menggunakan TypeScript dalam file App Script, cukup ganti nama ekstensi file dari
gs menjadi ts.
Mengedit file TypeScript lokal
Dengan menggunakan editor pilihan, Anda dapat menulis file TypeScript lokal sebagai file .ts di folder project.
Misalnya, file bernama index.ts dapat memiliki kode
TypeScript berikut:
const greeter = (person: string) => {
return `Hello, ${person}!`;
}
let user = 'Grant';
Logger.log(greeter(user));
Anda dapat menulis TypeScript dengan fitur ES6+ seperti
fungsi panah
dan interpolasi string (${var}). File ini ditranspilasi menjadi konstruksi Apps Script
saat Anda mengirim project ke server Apps Script.
Mengupload project Apps Script lokal yang menggunakan TypeScript
Setelah selesai mengedit file TypeScript dan Apps Script lokal, Anda
dapat mengupload file lokal ke Google Drive menggunakan perintah clasp
berikut:
clasp push --watch
Perintah ini memantau perubahan file TypeScript dan menggunakan typescript untuk mengompilasi kode dan clasp untuk mengupload project ke Google Drive.
Melaporkan masalah atau mengajukan permintaan fitur
Jika mengalami masalah dengan alat clasp, Anda dapat melaporkannya di
GitHub.
Jika Anda mengalami masalah atau bug pada TypeScript itu sendiri, Anda dapat melaporkannya di repositori GitHub TypeScript.