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) на основе исходного кода библиотеки.