TypeScript è un superset tipizzato di JavaScript che può essere compilato in puro Apps Script. Quando utilizzi TypeScript nello sviluppo di un progetto Apps Script, ottieni i seguenti vantaggi:
- Completamento automatico dell'IDE locale
- Tipizzazione strutturale facoltativa
- Deduzione del tipo, interfacce
- Funzionalità ES6 come classi e funzioni freccia.
Questa guida illustra alcune attività comuni per lo sviluppo di un progetto Apps Script con TypeScript.
Requisiti
Se non hai dimestichezza con TypeScript, consulta la documentazione di TypeScript e la guida rapida di TypeScript per familiarizzare con i concetti di base prima di tentare una delle procedure descritte in questa guida.
Per utilizzare TypeScript nei progetti Apps Script con clasp sono necessari i seguenti strumenti. Sebbene l'utilizzo di clasp non sia obbligatoria per attivare l'utilizzo di TypeScript in Apps Script, è vivamente consigliato in quanto semplifica notevolmente le procedure.
Prima di tentare una delle procedure descritte di seguito, assicurati di avere installato quanto segue per attivare l'ambiente di sviluppo locale:
- Node e npm
clasp:npm install -g @google/clasp- Definizioni dei tipi per Apps Script:
npm i -S @types/google-apps-script - Visual Studio Code (per il completamento automatico dell'IDE TypeScript)
Assicurati di leggere la documentazione di clasp
se non hai mai utilizzato clasp.
Utilizzo di TypeScript in un progetto Clasp
Puoi utilizzare clasp per creare rapidamente un nuovo progetto Apps Script locale.
Questo comando crea un file appsscript.json e un file Code.gs, la base di un progetto Apps Script.
Per utilizzare TypeScript in un file di Apps Script, rinomina semplicemente l'estensione del file da
gs a ts.
Modificare i file TypeScript locali
Utilizzando l'editor che preferisci, puoi scrivere file TypeScript locali come file .ts
nella cartella del progetto.
Ad esempio, un file denominato index.ts potrebbe avere il seguente codice TypeScript:
const greeter = (person: string) => {
return `Hello, ${person}!`;
}
let user = 'Grant';
Logger.log(greeter(user));
Puoi scrivere TypeScript con funzionalità ES6 e successive, come le funzioni freccia e l'interpolazione di stringhe (${var}). Questi file vengono transpilati in costrutti di Apps Script quando esegui il push del progetto sul server di Apps Script.
Caricare un progetto Apps Script locale che utilizza TypeScript
Quando hai finito di modificare i file TypeScript e Apps Script locali, puoi caricarli su Google Drive utilizzando il seguente comando clasp:
clasp push --watch
Questo comando controlla le modifiche ai file TypeScript e utilizza typescript per compilare il codice e clasp per caricare il progetto su Google Drive.
Segnalare problemi o inviare richieste di funzionalità
Se riscontri un problema con lo strumento clasp, puoi segnalarlo su
GitHub.
Se riscontri un problema o un bug con TypeScript stesso, puoi segnalarlo nel repository GitHub di TypeScript.