Présentation

Artiste : Daryna Mikhailenko
apps-script-utils est une bibliothèque TypeScript conçue spécifiquement pour Google Apps Script. Elle rassemble dans un seul paquet testé ce que tout projet GAS finit par écrire à la main : manipulation des feuilles et de la notation A1, validation des types et des valeurs (isX/nonX/requireX), transformations de chaînes et de tableaux, exceptions typées, et le reste.
Points clés
Conçue pour Google Apps Script — pensée pour l'environnement GAS et ses contraintes, et non adaptée d'une bibliothèque Node.js générique.
Couverture large — aides pour les feuilles, l'interface, le réseau et l'Admin SDK, aux côtés d'utilitaires généraux pour les chaînes, les tableaux et les objets.
TypeScript d'abord — chaque fonction est livrée avec ses définitions de types, pour l'autocomplétion et la sécurité à la compilation.
Testée — couverte par une suite de tests unitaires Vitest.
Référence liée — chaque type Google Apps Script employé dans l'API pointe directement vers sa documentation officielle.
Gestion d'erreurs cohérente — une hiérarchie de classes d'exception remplace les
throw new Errordispersés.
Organisation de cette documentation
Premiers pas — prérequis, installation et un premier script qui fonctionne.
Les guides expliquent les idées qui traversent toute la bibliothèque : Conventions de validation, Gestion des exceptions et L'environnement Apps Script.
Les modules décrivent chaque paquet et le montrent à l'œuvre : lang, appsscript, net et exception.
La référence des fonctions liste chaque fonction exportée, regroupée comme l'est le paquet lui-même : Module Google Apps Script, Utilitaires de base, Exceptions, Module path et Classes abstraites et interfaces. Chaque ligne de ces tableaux mène à une page dédiée — signature, paramètres, valeur de retour, exceptions et exemples commentés — et chaque fonction, classe et type exporté en possède une.
Écosystème — le framework boot.gs, qui dépend de cette bibliothèque, et les Agent Skills qui apprennent à un agent IA à s'en servir.
Appuyez sur / sur n'importe quelle page du site pour ouvrir la recherche.
Où la bibliothèque s'exécute
Le paquet se divise nettement en deux, et cette division détermine d'où une fonction peut être appelée :
Partie | Dépend de l'environnement Apps Script | Où elle s'exécute |
|---|---|---|
| Non | Apps Script, Node.js, les tests |
| Oui, pour les fonctions liées aux services | Apps Script uniquement |
L'environnement Apps Script détaille quelles fonctions relèvent de quel côté et ce que cela implique en pratique.
Structure du projet
Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.