Überblick

Künstlerin: Daryna Mikhailenko
apps-script-utils ist eine TypeScript-Bibliothek, die eigens für Google Apps Script gebaut wurde. Sie versammelt in einem getesteten Paket, was in jedem GAS-Projekt am Ende doch von Hand geschrieben wird: Arbeit mit Tabellen und A1-Notation, Typ- und Wertprüfungen (isX/nonX/requireX), String- und Array-Transformationen, typisierte Ausnahmen und mehr.
Wesentliche Eigenschaften
Für Google Apps Script gebaut — entworfen für die GAS-Laufzeit und ihre Grenzen, nicht aus einer Node.js-Bibliothek übernommen.
Breite Abdeckung — Helfer für Tabellen, Oberfläche, Netzwerk und Admin SDK neben allgemeinen Werkzeugen für Strings, Arrays und Objekte.
TypeScript zuerst — jede Funktion bringt vollständige Typdefinitionen für Autovervollständigung und Übersetzungszeit-Sicherheit mit.
Getestet — abgedeckt durch eine Unit-Test-Suite mit Vitest.
Verlinkte Referenz — jeder verwendete Google-Apps-Script-Typ verweist direkt auf seine offizielle Dokumentation.
Einheitliche Fehlerbehandlung — eine Hierarchie von Ausnahmeklassen statt verstreuter
throw new Error.
Wie diese Dokumentation aufgebaut ist
Erste Schritte — Voraussetzungen, Installation und ein erstes lauffähiges Skript.
Anleitungen erklären die Ideen, die die ganze Bibliothek durchziehen: Konventionen der Prüfungen, Ausnahmebehandlung und Die Apps-Script-Laufzeit.
Module beschreiben jedes Paket und zeigen es im Einsatz: lang, appsscript, net und exception.
Die Funktionsreferenz listet jede exportierte Funktion in derselben Gliederung wie das Paket selbst: Modul Google Apps Script, Basis-Werkzeuge, Ausnahmen, Modul path und Abstrakte Klassen und Schnittstellen. Jede Zeile dieser Tabellen hat eine eigene Seite — Signatur, Parameter, Rückgabewert, Ausnahmen und durchgearbeitete Beispiele — und jede exportierte Funktion, Klasse und jeder Typ hat eine solche Seite.
Ökosystem — das boot.gs-Framework, das von dieser Bibliothek abhängt, und die Agent Skills, die einem KI-Agenten den Umgang damit beibringen.
Drücken Sie auf jeder Seite /, um die Suche zu öffnen.
Wo die Bibliothek läuft
Das Paket zerfällt sauber in zwei Teile, und diese Trennung entscheidet, von wo eine Funktion aufgerufen werden kann:
Teil | Hängt von der Apps-Script-Laufzeit ab | Wo es läuft |
|---|---|---|
| Nein | Apps Script, Node.js, Tests |
| Ja, für die dienstgebundenen Funktionen | Nur Apps Script |
Die Apps-Script-Laufzeit behandelt, welche Funktionen auf welche Seite fallen und was das praktisch bedeutet.
Projektaufbau
Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.