Premiers pas

Prérequis

Node.js v22.14.0 ou plus récent
npm (ou un autre gestionnaire de paquets Node, par exemple pnpm)

Installation

npm install apps-script-utils

Tout est exporté depuis la racine du paquet : un seul chemin d'import couvre donc toute la bibliothèque.

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

Premiers exemples

Travailler avec Sheets

Ajouter plusieurs lignes de données en une fois :

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);

Utilitaires Admin SDK

Vérifier si l'utilisateur courant dispose des droits d'administration :

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

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

Analyse de la notation A1

Transformer une notation A1 composée en objet structuré :

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

Valider les entrées

La plupart des fonctions de la bibliothèque rejettent une entrée invalide plutôt que de la convertir. La famille requireX transforme une valeur non vérifiée en valeur typée — ou lève :

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

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

greet("Ada"); // "Hello, Ada!"
greet(""); // lève EmptyStringException
greet(42); // lève InvalidStringException

Conventions de validation explique tout le schéma de noms isX/nonX/requireX/requireNonX, et Gestion des exceptions couvre les exceptions que ces fonctions lèvent.

Pour aller plus loin

Conventions de validation — la convention de nommage que suit l'essentiel de la bibliothèque.
L'environnement Apps Script — quelles aides exigent l'environnement Apps Script, et ce que cela implique pour les tests.
Utilitaires de base — la liste complète des fonctions indépendantes de l'environnement.
Module Google Apps Script — la liste complète des fonctions liées aux services.

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.