Variables et constantes dans Apps Script

Les variables sont utilisées pour stocker des valeurs. Pour attribuer une valeur à une variable, vous devez d’abord déclarer la variable, puis lui attribuer une valeur.

Déclarer une variable

Vous pouvez déclarer une variable en utilisant le mot-clé let, suivi du nom de la variable.

let prenom;

Si vous n’avez pas encore attribué de valeur à la variable prenom, sa valeur sera undefined.

Attribuer une valeur à une variable

Une valeur peut être attribuée à une variable à l’aide de l’opérateur égal (=).

let prenom = "Jacques";

Vous pouvez également déclarer une variable d’abord et lui attribuer une valeur plus tard.

let prenom;
prenom = "Jacques";

Le mot-clé let ne doit être utilisé qu’au moment de la déclaration de la variable, ce qui n’arrive qu’une seule fois.

let prenom;
prenom = "Jacques";
Logger.log(prenom); // "Jacques"

Toujours déclarer une variable avant de lui attribuer une valeur

Bien qu’Apps Script permette d’attribuer une valeur à une variable non déclarée, il est fortement déconseillé de le faire. Cela créera une variable globale, ce qui peut entraîner des bogues dans votre programme.

// Mauvaise pratique
prenom = "Jacques"; // Cela crée une variable globale

// Bonne pratique : déclarer puis assigner
let prenom = "Jacques";

// Alternative : déclarer puis assigner plus tard
let prenom;
prenom = "Jacques";

Modifier la valeur d’une variable

Vous pouvez modifier la valeur d’une variable en lui attribuant une nouvelle valeur.

let prenom;
Logger.log(prenom); // undefined
prenom = "Jacques";
Logger.log(prenom); // "Jacques"
prenom = "Pierre";
Logger.log(prenom); // "Pierre"

Utiliser des opérateurs avec des variables

Les opérateurs permettent de réaliser des opérations sur les valeurs des variables.

let prix = 10.0;
let quantite = 20;
let montantTotal = prix * quantite;
Logger.log(montantTotal); // 200.0

Type d’une variable

Le type d’une variable correspond au type de la valeur qu’elle contient.

let prenom;
Logger.log(typeof prenom); // "undefined"
prenom = "Jacques";
Logger.log(typeof prenom); // "string"

Noms des variables

Voici les règles à suivre pour nommer vos variables :

  • Les noms de variables peuvent contenir des lettres, des chiffres, des underscores (_) ou des signes dollar ($).
  • Les noms doivent commencer par une lettre, un underscore ou un dollar.
  • Les noms ne peuvent pas contenir d’espaces.
  • Certains mots réservés, comme let ou const, ne peuvent pas être utilisés comme noms de variables.

Les noms de variables sont sensibles à la casse :

let prenom = "Jacques";
Logger.log(prenom); // "Jacques"
PRENOM = "Pierre";
Logger.log(prenom); // "Jacques" (la valeur initiale reste inchangée)
Logger.log(PRENOM); // "Pierre" (création d'une nouvelle variable globale par inadvertance)

Bonnes pratiques pour nommer des variables

  • Choisissez des noms significatifs, comme prenom, plutôt que aaa.
  • Utilisez des conventions lisibles, comme dateNaissance ou date_naissance.

Constantes

Les constantes ressemblent aux variables, sauf qu’il est impossible de modifier leur valeur une fois attribuée. Pour déclarer une constante, utilisez le mot-clé const.

const TAUX_TVA = 0.05;
Logger.log(TAUX_TVA); // 0.05

Si vous essayez de modifier une constante, Apps Script déclenchera une erreur.

Bonnes pratiques pour les constantes

  • Utilisez des majuscules pour les noms des constantes (TAUX_TVA).
  • Séparez les mots par des underscores (_).
let prix = 10.0;
let quantite = 20;
const TAUX_TVA = 0.05;
let montantTotal = prix * quantite * (1 + TAUX_TVA);
Logger.log(montantTotal); // 210.0

La suite du cours Apps Script avec l’article : Les objets dans Apps Script