Herbruikbare Apps Script library maken

Wat is een Apps Script library

Een Apps Script library is een herbruikbaar script-project dat je kunt delen met andere projecten of gebruikers. In plaats van dezelfde code te kopiëren naar meerdere projecten, definieer je gemeenschappelijke functies eenmalig in een library en importeer je die waar nodig.

Typische use cases zijn: gemeenschappelijke helper-functies, herbruikbare API-wrappers, configuratie-utilities en gestandaardiseerde logging.

Library aanmaken en publiceren

const LibVersie = '2.1.0';

function getVersie() {
  return LibVersie;
}

function formateerDatum(datum, tijdzone = 'Europe/Amsterdam', formaat = 'dd-MM-yyyy') {
  if (!(datum instanceof Date)) {
    datum = new Date(datum);
  }
  return Utilities.formatDate(datum, tijdzone, formaat);
}

function stuurSlackBericht(webhookUrl, tekst, kanaal = null) {
  const payload = {text: tekst};
  if (kanaal) payload.channel = kanaal;

  const response = UrlFetchApp.fetch(webhookUrl, {
    method: 'POST',
    contentType: 'application/json',
    payload: JSON.stringify(payload),
    muteHttpExceptions: true,
  });

  return response.getResponseCode() === 200;
}

function slugify(tekst) {
  return tekst
    .toLowerCase()
    .replace(/[àáâãäå]/g, 'a')
    .replace(/[èéêë]/g, 'e')
    .replace(/[ìíîï]/g, 'i')
    .replace(/[òóôõö]/g, 'o')
    .replace(/[ùúûü]/g, 'u')
    .replace(/[^a-z0-9\s-]/g, '')
    .replace(/\s+/g, '-')
    .replace(/-+/g, '-')
    .replace(/^-|-$/g, '');
}

Library importeren in een project

function gebruikLibrary() {
  const versie = Utils.getVersie();
  Logger.log(`Library versie: ${versie}`);

  const datum = Utils.formateerDatum(new Date());
  Logger.log(`Datum: ${datum}`);

  const slug = Utils.slugify('Hallo Wereld! @2026');
  Logger.log(`Slug: ${slug}`);
}

Naamruimte en zichtbaarheid

Alleen functies die niet beginnen met een underscore zijn beschikbaar in importerende projecten. Gebruik underscores voor interne helper-functies:

function publiekeFunctie() {
  return _internHelper();
}

function _internHelper() {
  return 'intern resultaat';
}

Versie-management

Houd binnen de library bij welke wijzigingen per versie zijn doorgevoerd. Dat maakt het voor importerende projecten duidelijk wanneer een upgrade veilig is en wanneer er een breaking change in zit.

const VERSIE_INFO = {
  major: 2,
  minor: 1,
  patch: 0,
  datum: '2026-06-02',
  wijzigingen: [
    'v2.1.0: slugify-functie toegevoegd',
    'v2.0.0: Breaking change: handtekening formateerDatum gewijzigd',
    'v1.0.0: Initiele release',
  ],
};

function getVersieInfo() {
  return JSON.stringify(VERSIE_INFO);
}

function checkMinimumVersie(vereistMajor, vereistMinor) {
  return VERSIE_INFO.major > vereistMajor ||
    (VERSIE_INFO.major === vereistMajor && VERSIE_INFO.minor >= vereistMinor);
}

Library testen

Schrijf testfuncties in het library-project zelf en draai ze daar. Zo controleer je de functies los van elk importerend project.

function runLibraryTests() {
  const fouten = [];

  const datum = formateerDatum(new Date('2026-01-15'));
  if (datum !== '15-01-2026') fouten.push(`formateerDatum fout: ${datum}`);

  const slug = slugify('He Wereld!');
  if (slug !== 'he-wereld') fouten.push(`slugify fout: ${slug}`);

  const versie = getVersie();
  if (!versie.match(/^\d+\.\d+\.\d+$/)) fouten.push(`versieformaat fout: ${versie}`);

  if (fouten.length === 0) {
    Logger.log('Alle tests geslaagd');
  } else {
    fouten.forEach(f => Logger.log('FOUT: ' + f));
    throw new Error(`${fouten.length} tests mislukt`);
  }
}

Praktisch voorbeeld: gedeelde Slack-helper

Stel dat meerdere automatiseringen in je team een Slack-melding moeten sturen bij een fout. In plaats van de webhook-logica in elk project te dupliceren, plaats je stuurSlackBericht() eenmaal in een library en roep je hem overal aan via Utils.stuurSlackBericht(...). Verandert er iets aan de aanroep van Slack, dan pas je het op een plek aan en hoog je de library-versie op.

Libraries zorgen voor consistentie en vermijden code-duplicatie over meerdere Apps Script projecten. Door een centrale library bij te houden voer je verbeteringen op een plek door, zonder elk project apart te wijzigen.