Développer Apps Script avec TypeScript

TypeScript est un sur-ensemble typé de JavaScript qui peut être compilé en Apps Script simple. Lorsque vous utilisez TypeScript pour développer un projet Apps Script, vous bénéficiez des avantages suivants:

Ce guide présente certaines tâches courantes pour développer un projet Apps Script avec TypeScript.

Conditions requises

Si vous ne connaissez pas TypeScript, consultez la documentation TypeScript et le guide de démarrage rapide TypeScript pour vous familiariser avec les concepts de base avant d'essayer l'une des procédures décrites dans ce guide.

Les outils suivants sont requis pour utiliser TypeScript dans les projets Apps Script avec clasp. Bien que l'utilisation de clasp ne soit pas strictement nécessaire pour activer l'utilisation de TypeScript dans Apps Script, elle est vivement recommandée, car elle simplifie grandement les procédures.

Avant d'effectuer l'un des processus décrits ci-dessous, assurez-vous d'avoir installé les éléments suivants pour activer votre environnement de développement local:

Veillez à vous familiariser avec la documentation clasp si vous n'avez jamais utilisé clasp auparavant.

Utiliser TypeScript dans un projet Clasp

Vous pouvez utiliser clasp pour créer rapidement un projet Apps Script local. Cette commande crée un appsscript.json et un Code.gs, qui constituent la base d'un projet Apps Script.

Pour utiliser TypeScript dans un fichier Apps Script, il vous suffit de renommer l'extension de fichier gs en ts.

Modifier des fichiers TypeScript locaux

À l'aide de l'éditeur de votre choix, vous pouvez écrire des fichiers TypeScript locaux en tant que fichiers .ts dans le dossier du projet.

Par exemple, un fichier nommé index.ts peut contenir le code TypeScript suivant:

const greeter = (person: string) => {
  return `Hello, ${person}!`;
}

let user = 'Grant';
Logger.log(greeter(user));

Vous pouvez écrire du TypeScript avec des fonctionnalités ES6 et ultérieures, telles que les fonctions flèches et l'interpolation de chaîne (${var}). Ces fichiers sont transcompilés en constructions Apps Script lorsque vous transférez le projet vers le serveur Apps Script.

Importer un projet Apps Script local qui utilise TypeScript

Lorsque vous avez terminé de modifier les fichiers TypeScript et Apps Script locaux, vous pouvez les importer dans Google Drive à l'aide de la commande clasp suivante:

clasp push --watch

Cette commande surveille les modifications apportées aux fichiers TypeScript et utilise typescript pour compiler le code et clasp pour importer le projet dans Google Drive.

Signaler des problèmes ou demander des fonctionnalités

Si vous rencontrez un problème avec l'outil clasp, vous pouvez le signaler sur GitHub.

Si vous rencontrez un problème ou un bug avec TypeScript lui-même, vous pouvez le signaler dans le dépôt GitHub de TypeScript.