requireService

function requireService<T>(
  service: T | null | undefined,
  message: string = "Service is not defined."
): T;

Ein nie aktivierter erweiterter Dienst ist schlicht eine undefinierte globale Variable, und der Fehler fällt weit entfernt von seiner Ursache als ReferenceError an. Hier wird daraus eine benannte Ausnahme mit einer Meldung, die sagt, was einzuschalten ist.

Parameter

Parameter	Typ	Beschreibung
`service`	`T \\| null \\| undefined`	Der zu prüfende Dienst.
`message` (optional) `= "Service is not defined."`	`string`	Die Meldung der Ausnahme. Ohne Angabe wird eine Standardmeldung verwendet.

Rückgabewert

T — denselben Dienst.

Ausnahmen

Ausnahme	Bedingung
`ServiceIsNotDefinedException`	der Dienst ist `null` oder `undefined`.

Beispiele

Im Einsatz

// An advanced service is a global that only exists once it has been enabled.
const directory = requireService(AdminDirectory, "Enable the Admin SDK service.");

Siehe auch

Quellcode

src/appsscript/requireService.ts

23 September 2026

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