Erste Schritte

Voraussetzungen

Node.js ab Version 22.14.0
npm (oder ein anderer Node-Paketmanager, etwa pnpm)

Installation

npm install apps-script-utils

Alles wird aus der Paketwurzel exportiert, ein einziger Importpfad deckt also die ganze Bibliothek ab:

import { appendRows, isAdmin, parseA1Notation, requireString } from "apps-script-utils";

Erste Beispiele

Arbeiten mit Tabellen

Mehrere Datenzeilen in einem Zug anhängen:

import { appendRows } from "apps-script-utils";

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
const data = [
  ["John Doe", "john@example.com", 28],
  ["Jane Smith", "jane@example.com", 32]
];

appendRows(sheet, data);

Admin-SDK-Werkzeuge

Prüfen, ob der aktuelle Nutzer Administratorrechte hat:

import { isAdmin } from "apps-script-utils";

if (isAdmin()) {
  Logger.log("Access granted to admin panel.");
} else {
  Logger.log("Access denied.");
}

A1-Notation zerlegen

Eine zusammengesetzte A1-Notation in ein strukturiertes Objekt überführen:

import { parseA1Notation } from "apps-script-utils";

const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");

console.log(rangeInfo.sheetName); // "Sheet1"
console.log(rangeInfo.startRowIndex); // 0
console.log(rangeInfo.endColumnIndex); // 2

Eingaben prüfen

Die meisten Funktionen der Bibliothek weisen falsche Eingaben zurück, statt sie umzuwandeln. Die requireX-Familie macht aus einem ungeprüften Wert einen typisierten — oder wirft:

import { requireString, requireNonEmptyString } from "apps-script-utils";

function greet(name: unknown): string {
  return `Hello, ${requireNonEmptyString(name)}!`;
}

greet("Ada"); // "Hello, Ada!"
greet(""); // wirft EmptyStringException
greet(42); // wirft InvalidStringException

Konventionen der Prüfungen erklärt das ganze Namensschema isX/nonX/requireX/requireNonX, und Ausnahmebehandlung behandelt die Ausnahmen, die diese Funktionen werfen.

Wie es weitergeht

Konventionen der Prüfungen — die Namenskonvention, der der größte Teil der Bibliothek folgt.
Die Apps-Script-Laufzeit — welche Helfer die Apps-Script-Laufzeit brauchen und was das fürs Testen bedeutet.
Basis-Werkzeuge — die vollständige Liste der laufzeitunabhängigen Funktionen.
Modul Google Apps Script — die vollständige Liste der dienstgebundenen Funktionen.

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.