Обзор

apps-script-utils — библиотека утилит на TypeScript, созданная специально для Google Apps Script. Она собирает в одном протестированном пакете то, что в каждом проекте на GAS всё равно приходится писать руками: работу с таблицами и нотацией A1, проверку типов и значений (isX/nonX/requireX), преобразования строк и массивов, типизированные исключения и многое другое.

Ключевые возможности

Сделано для Google Apps Script — спроектировано под среду выполнения GAS и её ограничения, а не адаптировано из библиотеки для Node.js.
Широкое покрытие — помощники для таблиц, интерфейса, сети и Admin SDK рядом с универсальными утилитами для строк, массивов и объектов.
TypeScript в первую очередь — у каждой функции полные описания типов для автодополнения в IDE и проверки на этапе компиляции.
Покрыто тестами — модульные тесты на Vitest.
Документация со ссылками — каждый тип Google Apps Script, встречающийся в API, ведёт прямо в официальную документацию.
Единая обработка ошибок — иерархия классов исключений вместо разрозненных throw new Error.

Как устроена эта документация

Первые шаги — требования, установка и первый рабочий скрипт.
Руководства объясняют идеи, проходящие через всю библиотеку: Соглашения о проверках, Обработка исключений и Среда выполнения Apps Script.
Модули описывают каждый пакет и показывают его в деле: lang, appsscript, net и exception.
Справочник функций перечисляет все экспортируемые функции в той же группировке, что и сам пакет: Модуль Google Apps Script, Базовые утилиты, Исключения, Модуль path и Абстракции и интерфейсы. У каждой строки этих таблиц есть отдельная страница — сигнатура, параметры, возвращаемое значение, исключения и разобранные примеры, — и такая страница есть у каждой экспортируемой функции, класса и типа.
Экосистема — фреймворк boot.gs, который зависит от этой библиотеки, и Agent Skills, которые учат ИИ-агента ею пользоваться.

Нажмите / на любой странице сайта, чтобы открыть поиск.

Где работает библиотека

Пакет чётко делится на две части, и это деление определяет, откуда функцию можно вызвать:

Часть	Зависит от среды Apps Script	Где выполняется
`lang`, `net`, `json`, `html`, `time`, `exception`	Нет	Apps Script, Node.js, тесты
`appsscript`	Да, для функций, привязанных к сервисам	Только Apps Script

Среда выполнения Apps Script разбирает, какие функции к какой части относятся и что это значит на практике.

Структура проекта

.
├── config/           # Файлы конфигурации
├── dist/             # Результат сборки
├── docs/             # Документация: ресурсы и исходники этого сайта
├── scripts/          # Служебные и вспомогательные скрипты
├── src/              # Исходный код
│   ├── appsscript/   # Утилиты для Google Apps Script
│   ├── exception/    # Классы исключений
│   ├── html/         # Утилиты для HTML
│   ├── json/         # Утилиты для JSON
│   ├── lang/         # Языковые утилиты (массивы, строки и т. д.)
│   ├── net/          # Сеть и пути
│   ├── time/         # Работа со временем
│   └── index.ts      # Точка входа
├── test/             # Модульные тесты
└── vitest.config.ts  # Конфигурация Vitest

23 September 2026

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