apps-script-utils 2.1.1 Help

Overview

Project banner for Google Apps Script Utils

Artist: Daryna Mikhailenko

apps-script-utils is a TypeScript utility library purpose-built for Google Apps Script. It brings together the helpers every GAS project ends up writing by hand — spreadsheet and A1-notation manipulation, type/value validation (isX/nonX/requireX), string and array transforms, typed exceptions, and more — in a single, well-documented, and fully tested package.

Key features

  • Built for Google Apps Script — designed around the GAS runtime and its constraints, not adapted from a generic Node.js library.

  • Broad utility coverage — spreadsheet, UI, network, and Admin SDK helpers alongside general-purpose string, array, and object utilities.

  • TypeScript-first — every function ships with full type definitions for IDE autocompletion and compile-time safety.

  • Tested — covered by a Vitest unit test suite.

  • Linked reference documentation — every Google Apps Script type used in the API links directly to its official documentation.

  • Consistent error handling — a dedicated hierarchy of exception classes replaces ad-hoc thrown errors.

How this documentation is organised

Press / anywhere on this site to search it.

Where the library runs

The package splits cleanly in two, and the split decides where a function can be called:

Part

Depends on the Apps Script runtime

Where it runs

lang, net, json, html, time, exception

No

Apps Script, Node.js, the test suite

appsscript

Yes, for the service-bound functions

Apps Script only

The Apps Script runtime covers which functions fall on which side and what that means in practice.

Project layout

. ├── config/ # Configuration files ├── dist/ # Compiled output (after build) ├── docs/ # Documentation: assets and the source of this site ├── scripts/ # Maintenance and helper scripts ├── src/ # Source code │ ├── appsscript/ # Google Apps Script specific utilities │ ├── exception/ # Custom exception classes │ ├── html/ # HTML utilities │ ├── json/ # JSON utilities │ ├── lang/ # Language-level utilities (array, string, etc.) │ ├── net/ # Network and path utilities │ ├── time/ # Time-related utilities │ └── index.ts # Main entry point ├── test/ # Unit tests └── vitest.config.ts # Vitest configuration
23 September 2026

This documentation was generated with AI (Claude) from the library's source code.