Cours Apps Script : les fonctions

Une fonction exécute une série d'instructions lorsqu'elle est appelée.

Vous en avez utilisé dès le début de ce cours :

function exemple() {

}

Exécuter une fonction

Jusque-là, vous avez exécuté une seule fonction et vous l'avez fait à partir de l'éditeur Apps Script ou en assignant la fonction à une forme ou une image.

Mais une fonction peut aussi être appelée depuis une autre fonction.

En voici un exemple avec une fonction qui va servir à afficher un message d'erreur dans la console et qui va prendre en argument le texte de l'erreur :

// Affiche un message dans la console
function messageErreur(informationErreur) {
  console.log('Erreur : ' + informationErreur);
}

Vous pouvez ensuite appeler cette fonction à partir d'autres fonctions à chaque fois que c'est utile :

function test() {
  messageErreur('le champ "Nom" est vide');
  messageErreur('le champ "Prénom" est vide');
  messageErreur('le champ "Code postal" est invalide');
}

Lorsque vous faites des tests dans l'éditeur, vérifiez que vous exécutez la bonne fonction :

Valeur de retour

Une fonction peut retourner une valeur lorsque c'est utile.

Voici par exemple une fonction simple qui calcule la moyenne de 2 nombres :

// Calcule la moyenne de 2 nombres
function moyenne(nombre1, nombre2) {
  const resultat = (nombre1 + nombre2) / 2;
  return resultat;
}

La fonction retourne alors une valeur grâce à l'instruction return.

Dans ce cas, le calcul de la moyenne peut aussi être ajouté directement après return :

// Calcule la moyenne de 2 nombres
function moyenne(nombre1, nombre2) {
  return (nombre1 + nombre2) / 2;
}

Vous pouvez ensuite récupérer la valeur retournée par la fonction par exemple dans une constante ou une variable :

function test() {

  const tabNombres = [10, 20, 30];

  // Moyenne du premier et du second nombre du tableau
  const moyenne1 = moyenne(tabNombres[0], tabNombres[1])
  console.log(moyenne1); // Affiche : 15

  // Moyenne du second et du troisième nombre du tableau
  const moyenne2 = moyenne(tabNombres[1], tabNombres[2])
  console.log(moyenne2); // Affiche : 25
}

Utiliser une fonction dans Google Sheets

Vous pouvez aussi utiliser vos fonctions (avec une valeur de retour) dans les cellules comme les autres fonctions de Google Sheets.

Par exemple, cette fonction va prendre une plage en argument et retourner la dernière ligne de la plage :

// Retourne la dernière ligne d'une plage
function DERNIERE_LIGNE_PLAGE(plage) {
  return [plage[plage.length - 1]];
}

Vous pouvez ensuite vous en servir sur votre feuille :