exception

exception содержит классы ошибок, которые бросает остальная библиотека. Ничто в нём не зависит от среды выполнения Apps Script.

Пакеты

Пакет	Содержит
`exception`	базовые классы и исключения общего назначения
`exception/appsscript`	сбои помощников для Таблиц, Презентаций и Admin SDK
`exception/net`	сбои аутентификации

Иерархия, приёмы перехвата и таблица «какая функция что бросает» — в Обработка исключений. Эта страница о том, как пользоваться классами в собственном коде.

Расширение иерархии

Скрипт со своими сбоями может войти в иерархию, а не бросать голые Error. Для всего, что возникает во время работы, наследуйте RuntimeException:

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

export class QuotaExceededException extends RuntimeException {}

Это весь класс. Exception задаёт name из new.target, поэтому подкласс сообщает собственное имя без собственного конструктора:

const error = new QuotaExceededException("daily email quota reached");

error.name; // "QuotaExceededException"
error.getMessage(); // "daily email quota reached"
Object.prototype.toString.call(error); // "[object QuotaExceededException]"

Он же наследует поведение, важное в месте перехвата: Exception.isException() его распознаёт, а instanceof RuntimeException истинно.

Оборачивание пойманной ошибки

Любой конструктор принимает существующую Error и переиспользует её сообщение — исходный текст сохраняется, а тип меняется:

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

try {
  UrlFetchApp.fetch(endpoint);
} catch (error) {
  throw new RuntimeException(error);
}

Выбор класса

Предпочитайте существующий класс, если он подходит: тот, кто уже обрабатывает IllegalArgumentException, обработает и ваш случай:

Ситуация	Класс
Аргумент не того типа или вне диапазона	`IllegalArgumentException`
Обязательное значение оказалось `null`/`undefined`	`NullPointerException`
Строковый аргумент оказался пустым	`EmptyStringException`
Учётные данные отсутствуют или отвергнуты	`AuthenticationException`
Зависимость так и не была настроена	`ServiceIsNotDefinedException`, `RepositoryIsNotDefinedException`

Полный список

Исключения перечисляет все классы со ссылкой на исходный код.

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.