TypeScript es un superconjunto escrito de JavaScript que se puede compilar en Apps Script simple. Cuando usas TypeScript en el desarrollo de un proyecto de Apps Script, obtienes los siguientes beneficios:
- Autocompletado de IDE local
- Escritura estructural opcional
- Inferencia de tipo, interfaces
- Funciones de ES6, como clases y funciones de flecha
En esta guía, se abordan algunas tareas comunes para desarrollar un proyecto de Apps Script con TypeScript.
Requisitos
Si no estás familiarizado con TypeScript, revisa la documentación y la guía de inicio rápido de TypeScript para familiarizarte con los conceptos básicos antes de probar cualquiera de los procedimientos descritos en esta guía.
Se requieren las siguientes herramientas para usar TypeScript en proyectos de Apps Script
con clasp
. Si bien el uso de clasp
no es
estrictamente necesario para habilitar el uso de TypeScript en Apps Script, es muy
recomendado, ya que simplifica los procedimientos en gran medida.
Antes de intentar cualquiera de los procesos que se describen a continuación, asegúrate de haber instalado lo siguiente para habilitar tu entorno de desarrollo local:
- Nodo y npm
clasp
:npm install -g @google/clasp
- Definiciones de tipos para Apps Script:
npm i -S @types/google-apps-script
- Visual Studio Code (para el autocompletado del IDE de TypeScript)
Asegúrate de familiarizarte con la documentación de clasp
si no usaste clasp
antes.
Cómo usar TypeScript en un proyecto de Clasp
Puedes usar clasp
para crear un nuevo proyecto local de Apps Script con rapidez.
Con este comando, se crean appsscript.json
y Code.gs
, la base de un proyecto de Apps Script.
Para usar TypeScript en un archivo de App Script, simplemente cambia el nombre de la extensión del archivo de gs
a ts
.
Cómo editar archivos locales de TypeScript
Con tu editor preferido, puedes escribir archivos locales de TypeScript como archivos .ts
en la carpeta del proyecto.
Por ejemplo, un archivo llamado index.ts
podría tener el siguiente código de TypeScript:
const greeter = (person: string) => {
return `Hello, ${person}!`;
}
let user = 'Grant';
Logger.log(greeter(user));
Puedes escribir en TypeScript con funciones de ES6+, como
funciones de flecha
y la interpolación de cadenas (${var}
). Estos archivos se transpilan en construcciones de Apps Script
cuando envías el proyecto al servidor de Apps Script.
Sube un proyecto local de Apps Script que use TypeScript
Cuando termines de editar los archivos locales de TypeScript y Apps Script, puedes
subirlos a Google Drive con el siguiente comando
clasp
:
clasp push --watch
Este comando detecta los cambios en el archivo TypeScript y usa typescript
para compilar el código y clasp
para subir el proyecto a Google Drive.
Informa problemas o presenta una solicitud de función
Si tienes un problema con la herramienta de clasp
, puedes informarlo en GitHub.
Si encuentras un problema o error en TypeScript, puedes informarlo en el repositorio de GitHub de TypeScript.