requireService

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

Неувімкнений розширений сервіс — це просто невизначена глобальна змінна, і падіння стається далеко від причини, у вигляді ReferenceError. Тут воно перетворюється на іменований виняток із повідомленням про те, що треба увімкнути.

Параметри

Параметр	Тип	Опис
`service`	`T \\| null \\| undefined`	Сервіс, що перевіряється.
`message` (необов'язковий) `= "Service is not defined."`	`string`	Повідомлення винятку. Якщо не задано, використовується типове повідомлення.

Повертає

T — той самий сервіс.

Винятки

Виняток	Умова
`ServiceIsNotDefinedException`	сервіс дорівнює `null` або `undefined`.

Приклади

Застосування

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

Дивіться також

Вихідний код

src/appsscript/requireService.ts

23 September 2026

Цю документацію згенеровано нейромережею (Claude) на основі вихідного коду бібліотеки.