Cours Apps Script : les variables

Avant d'aller plus loin, vous avez besoin de comprendre certains concepts de base tels que les variables et les tableaux qui vous seront très utiles par la suite.

Les variables

Une variable permet de stocker une valeur (numérique, texte ou autre) pour pouvoir la réutiliser plus loin dans le code.

Avant d'utiliser une variable, vous devez commencer par la déclarer avec l'instruction let suivi du nom de la variable et d'un ; à la fin de la ligne :

let variable;

Pour une meilleure lisibilité de votre code, choisissez des noms qui décrivent bien le contenu de la variable. Par exemple pour une variable qui va contenir le coût total annuel, vous pouvez la nommer :

let coutTotalAnnuel;

Pour le moment la variable coutTotalAnnuel a été déclarée mais aucune valeur ne lui a été affectée.

Pour lui attribuer la valeur 100, ajoutez une seconde ligne :

let coutTotalAnnuel;
coutTotalAnnuel = 100;

Ou plus simplement, attribuez-lui cette valeur lors de la déclaration de la variable :

let coutTotalAnnuel = 100;

Les types

Une variable peut stocker toutes sortes de valeurs, par exemple des valeurs numériques :

let exempleValeur1 = 123;
let exempleValeur2 = 12.345;
let exempleValeur3 = -54.3;

Une variable peut stocker des valeurs au format texte entre '', "" ou `` :

let exempleValeur1 = 'Sheets-Pratique';
let exempleValeur2 = "Cours";
let exempleValeur3 = `Apps Script`;

Notez que si votre texte contient des ' ou des ", le plus simple est d'entourer le texte avec un autre caractère (ou de l'échapper avec le caractère \).

Exemple avec le texte Cours "Apps Script" :

let exempleValeur1 = 'Cours "Apps Script"';
let exempleValeur2 = "Cours \"Apps Script\"";
let exempleValeur3 = `Cours "Apps Script"`;

Une variable peut stocker des valeurs booléennes true (VRAI) ou false (FAUX) :

let exempleValeur1 = true;
let exempleValeur2 = false

Une variable peut également stocker des éléments plus complexes tels que des tableaux, des objets, des fonctions, ..., que nous verrons un peu plus tard dans ce cours.

Tester une valeur

Dans cet exemple 3 variables sont déclarées, la première est égale à 10, la seconde à 20 et la troisième à la somme des 2 premières :

let valeur1 = 10;
let valeur2 = 20;
let valeur3 = valeur1 + valeur2;

Pour tester et vérifier la valeur d'une variable, ajoutez :

console.log();

Puis entre parenthèses, entrez la valeur à tester (ici, celle de la variable valeur3) :

let valeur1 = 10;
let valeur2 = 20;
let valeur3 = valeur1 + valeur2;

console.log(valeur3);

Et pour exécuter ce bout de code, ouvrez le document de la leçon précédente (celui où vous avez déjà autorisé les macros), rendez-vous dans l'éditeur et entrez le code dans la fonction présente par défaut :

Cliquez ensuite sur Exécuter pour exécuter la fonction.

Vous retrouverez alors dans le journal d'exécution la valeur renvoyée par console.log, 30 :

Vous pouvez ajouter plusieurs console.log si nécessaire :

let valeur1 = 10;
let valeur2 = 20;
let valeur3 = valeur1 + valeur2;

console.log(valeur1);
console.log(valeur2);
console.log(valeur3);