Огляд

Художниця: Дарина Михайленко
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 | Де виконується |
|---|---|---|
| Ні | Apps Script, Node.js, тести |
| Так, для функцій, прив'язаних до сервісів | Лише Apps Script |
Середовище виконання Apps Script розбирає, які функції до якої частини належать і що це означає на практиці.
Структура проєкту
Цю документацію згенеровано нейромережею (Claude) на основі вихідного коду бібліотеки.