Перші кроки

Вимоги

Node.js версії 22.14.0 або новішої
npm (або інший менеджер пакетів Node, наприклад pnpm)

Встановлення

npm install apps-script-utils

Усе експортується з кореня пакета, тому одного шляху імпорту достатньо для всієї бібліотеки:

import { appendRows, isAdmin, parseA1Notation, requireString } from "apps-script-utils";

Перші приклади

Робота з Таблицями

Ефективно додати кілька рядків даних:

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

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
const data = [
  ["John Doe", "john@example.com", 28],
  ["Jane Smith", "jane@example.com", 32]
];

appendRows(sheet, data);

Утиліти Admin SDK

Перевірити, чи має поточний користувач права адміністратора:

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

if (isAdmin()) {
  Logger.log("Access granted to admin panel.");
} else {
  Logger.log("Access denied.");
}

Розбір нотації A1

Перетворити складну нотацію A1 на структурований об'єкт:

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

const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");

console.log(rangeInfo.sheetName); // "Sheet1"
console.log(rangeInfo.startRowIndex); // 0
console.log(rangeInfo.endColumnIndex); // 2

Перевірка вхідних даних

Більшість функцій бібліотеки відхиляють хибний ввід, а не приводять його до чогось. Родина requireX перетворює неперевірене значення на типізоване — або кидає виняток:

import { requireString, requireNonEmptyString } from "apps-script-utils";

function greet(name: unknown): string {
  return `Hello, ${requireNonEmptyString(name)}!`;
}

greet("Ada"); // "Hello, Ada!"
greet(""); // кидає EmptyStringException
greet(42); // кидає InvalidStringException

Домовленості про перевірки розбирає всю схему імен isX/nonX/requireX/requireNonX, а Обробка винятків — винятки, які ці функції кидають.

Куди далі

Домовленості про перевірки — домовленість про імена, якій підпорядкована більша частина бібліотеки.
Середовище виконання Apps Script — яким помічникам потрібне середовище Apps Script і що це означає для тестів.
Базові утиліти — повний список функцій, що не залежать від середовища виконання.
Модуль Google Apps Script — повний список функцій, прив'язаних до сервісів.

23 September 2026

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