Comprendre et utiliser les fonctions dans Google Apps Script

Publié le par

Les fonctions sont des blocs de code réutilisables qui exécutent des tâches spécifiques. Elles jouent un rôle clé dans la création de scripts organisés et faciles à maintenir, en permettant la réutilisation du code et en favorisant une meilleure organisation.

Qu’est-ce qu’une fonction ?

Une fonction est un morceau de code nommé, que vous pouvez exécuter n’importe où dans votre programme en appelant son nom. Cela permet de réutiliser du code au lieu de le dupliquer à plusieurs endroits.

Ce que peuvent faire les fonctions :

  1. Accepter des valeurs d’entrée appelées paramètres.
  2. Traiter ces valeurs à l’aide du code interne de la fonction.
  3. Retourner une valeur de sortie utilisable ailleurs dans le programme.
  4. Être réutilisées autant de fois que nécessaire.

Structure d’une fonction :

function nomDeLaFonction(paramètre1, paramètre2) {

    // Code qui traite les paramètres

    return valeurDeSortie;

}

Décryptons chaque partie :

  • function : Indique que vous créez une fonction.
  • nomDeLaFonction : Nom que vous utiliserez pour appeler cette fonction.
  • Paramètres : Valeurs entre parenthèses nécessaires à l’exécution.
  • Code : Instructions entre les accolades {} exécutées lorsque la fonction est appelée.
  • return : Spécifie la valeur renvoyée par la fonction.

Paramètres des fonctions

Les paramètres sont des variables qui stockent les valeurs passées à une fonction. Voici leurs caractéristiques :

  • Listés entre parenthèses après le nom de la fonction.
  • Séparés par des virgules en cas de multiples paramètres.
  • Optionnels (une fonction peut ne pas en avoir).

Exemple 1 : Fonction sans paramètres

function direBonjour() {

    return "Bonjour !";

}

Exemple 2 : Fonction avec plusieurs paramètres

function calculerAireRectangle(largeur, hauteur) {

    return largeur * hauteur;

}

⚠️ Les lignes commençant par // sont des commentaires. Apps Script les ignore, mais elles aident à documenter le code.

Valeurs de retour

Une fonction peut renvoyer une valeur grâce au mot-clé return. Cela permet d’utiliser cette valeur ailleurs dans le programme.

Exemple :

function additionner(a, b) {

    return a + b;

}

Points clés sur les valeurs de retour :

  • Une fonction peut renvoyer n’importe quel type de valeur (nombre, chaîne, booléen, etc.).
  • Une fonction peut aussi ne rien renvoyer (on parle alors de fonction vide).
  • Dès qu’une fonction atteint une instruction return, elle s’arrête immédiatement.

Noms de fonctions : règles et bonnes pratiques

Règles :

  • Les noms peuvent contenir lettres, chiffres, $ et _.
  • Ne peuvent pas commencer par un chiffre.
  • Sensibles à la casse (maFonction ≠ MaFonction).

Bonnes pratiques :

  • Utilisez des noms descriptifs : calculerAire, envoyerEmail.
  • Pour les noms composés, utilisez le camelCase : envoyerMessageTexte, ou des underscores : envoyer_message_texte.

Pourquoi utiliser des fonctions ?

Les fonctions simplifient et optimisent votre code en :

  1. Réutilisant du code : Évitez les répétitions inutiles.
  2. Modularisant : Chaque fonction peut se concentrer sur une tâche unique.
  3. Organisant : Les problèmes complexes sont découpés en blocs plus gérables.

Créer votre première fonction

Voici une fonction simple pour calculer le pourcentage d’une note :

function calculerPourcentage(score, totalPoints) {

    var pourcentage = (score / totalPoints) * 100;

    return pourcentage;

}

Utilisation :

var resultat = calculerPourcentage(85, 100);

Logger.log(resultat); // Affiche : 85.0

Meilleures pratiques pour écrire des fonctions

  1. Utilisez des noms descriptifs.
  2. Gardez vos fonctions courtes et concentrées sur une seule tâche.
  3. Donnez des noms clairs à vos paramètres.
  4. Commentez les parties complexes de votre code.
  5. Assurez-vous que vos fonctions renvoient des types de données cohérents.

Erreurs courantes à éviter

• Appeler une fonction avant de la définir.

• Oublier d’ajouter une instruction return lorsque c’est nécessaire.

• Essayer d’utiliser un paramètre en dehors de la fonction.

Exemple avancé : Fonction sans paramètres ni retour

Une fonction peut ne pas nécessiter d’entrées ni de retour :

function afficherMessage() {

    Logger.log("Bonjour tout le monde !");

}

Grâce à ces bases sur les fonctions dans Google Apps Script, vous pouvez créer des scripts plus robustes, organisés et faciles à maintenir. En maîtrisant les fonctions, vous franchirez une étape essentielle dans votre apprentissage de la programmation.