TypeScript es un superconjunto tipado 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 del IDE local
- Escritura estructural opcional
- Inferencia de tipos, 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 de TypeScript y la guía de inicio rápido de TypeScript para familiarizarte con los conceptos básicos antes de intentar realizar cualquiera de los procedimientos que se describen en esta guía.
Se requieren las siguientes herramientas para usar TypeScript en proyectos de Apps Script con clasp. Si bien no es
necesario usar clasp para habilitar el uso de TypeScript en Apps Script, se recomienda
hacerlo, ya que simplifica mucho los procedimientos.
Antes de intentar realizar cualquiera de los procesos que se describen a continuación, asegúrate de haber instalado lo siguiente para habilitar tu entorno de desarrollo local:
- Node 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 la finalización automática del IDE de TypeScript)
Asegúrate de familiarizarte con la documentación de clasp
si nunca antes usaste clasp.
Cómo usar TypeScript en un proyecto de Clasp
Puedes usar clasp para crear rápidamente un nuevo proyecto de Apps Script local.
Este comando crea un appsscript.json y un Code.gs, la base de un proyecto de Apps Script.
Para usar TypeScript en un archivo de Apps Script, simplemente cambia el nombre de la extensión de archivo de gs a ts.
Cómo editar archivos TypeScript locales
Con tu editor preferido, puedes escribir archivos TypeScript locales 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 TypeScript con funciones de ES6 y versiones posteriores, como
funciones de flecha
y 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 de Apps Script local 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 los archivos de TypeScript y usa typescript para compilar
el código y clasp para subir el proyecto a Google Drive.
Informa problemas o envía solicitudes de funciones
Si encuentras un problema con la herramienta clasp, puedes informarlo en
GitHub.
Si encuentras un problema o un error con TypeScript, puedes informarlo en el repositorio de GitHub de TypeScript.