TypeScript adalah superset berjenis dari JavaScript yang dapat dikompilasi menjadi Apps Script biasa. Saat menggunakan TypeScript dalam pengembangan project Apps Script, Anda akan mendapatkan manfaat berikut:
- Pelengkapan otomatis IDE lokal
- Pengetikan struktural opsional
- Inferensi jenis, antarmuka
- Fitur ES6, seperti class dan fungsi panah.
Panduan ini membahas beberapa tugas umum untuk mengembangkan project Apps Script dengan TypeScript.
Persyaratan
Jika Anda tidak terbiasa dengan TypeScript, tinjau dokumentasi TypeScript dan panduan memulai TypeScript untuk memahami konsep dasar sebelum mencoba prosedur apa pun yang dijelaskan dalam panduan ini.
Alat berikut diperlukan untuk menggunakan TypeScript dalam project Apps Script dengan clasp
. Meskipun penggunaan clasp
tidak
sangat diperlukan untuk mengaktifkan penggunaan TypeScript di Apps Script, penggunaan
TypeScript di Apps Script sangat direkomendasikan karena dapat sangat menyederhanakan prosedur.
Sebelum mencoba salah satu proses yang dijelaskan di bawah ini, pastikan Anda telah menginstal yang 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 pelengkapan otomatis IDE TypeScript)
Pastikan Anda memahami dokumentasi clasp
jika Anda belum pernah menggunakan clasp
sebelumnya.
Menggunakan TypeScript dalam Project Gesper
Anda dapat menggunakan clasp
untuk
membuat project Apps Script lokal baru dengan cepat.
Perintah ini membuat appsscript.json
dan Code.gs
, dasar dari project Apps Script.
Untuk menggunakan TypeScript di 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
dalam 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 ke dalam konstruksi Apps Script
saat Anda mengirimkan 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 mengawasi perubahan file TypeScript dan menggunakan typescript
untuk mengompilasi
kode dan clasp
untuk mengupload project ke Google Drive.
Laporkan masalah atau ajukan permintaan fitur
Jika mengalami masalah dengan alat clasp
, Anda dapat melaporkannya di
GitHub.
Jika mengalami masalah atau bug pada TypeScript, Anda dapat melaporkannya di repositori GitHub TypeScript.