---
title: Variables dans les tests
description: Définissez, générez et réutilisez des valeurs dynamiques dans un test grâce au sélecteur de variables.
sidebarTitle: Variables dans les tests
lastUpdated: "2026-09-23"
---
> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.
Les données de test statiques deviennent rapidement obsolètes : un email codé en dur provoque une collision lors de la deuxième inscription, un nom fixe ne peut pas prouver que la page de confirmation affiche ce que vous avez saisi. Dans un test, les variables alimentent chaque step avec des données dynamiques : des valeurs produites par des steps précédents, générées à la volée, ou récupérées depuis la configuration de votre produit.
## Trois natures de variable
Quel que soit le champ, une valeur peut mélanger du texte littéral et trois natures de variable, chacune avec sa couleur dans l'éditeur :
- **Les variables de test**, en orange : elles vivent dans ce test. Un step qui produit une valeur en crée une (`SmsCode`, `Extracted`), un step **Set variable** en déclare une, et vous pouvez en créer une vous-même depuis le sélecteur.
- **Les variables globales et les groupes de variables**, en bleu : définis une fois pour le produit dans les [Configurations](/fr/tests/configurations), réutilisés par tous les tests.
- **Les aléatoires intégrés**, en gris : générés à chaque exécution, stockés nulle part.
La couleur est le moyen le plus rapide de lire un champ : l'orange reste dans le test, le bleu vient du produit, le gris est généré.
## Le sélecteur de variables
Cliquez sur l'icône `{}` à côté de n'importe quel champ de step pour ouvrir le sélecteur de variables. Sélectionner une entrée l'insère sous forme de pastille dans le champ, où elle peut se combiner avec du texte littéral. Le sélecteur comporte trois onglets :
- **Previous steps** : valeurs produites précédemment dans le test, avec **Create in-test variable** en bas de l'onglet.
- **Random** : données fictives générées pour cette exécution.
- **Variables** : les variables et groupes de variables configurés dans votre produit, avec un raccourci pour créer une variable globale sans quitter le test.
## Previous steps
Chaque step qui produit une valeur l'exporte comme variable, listée avec le step qui l'a créée (par exemple `SmsCode`, Step 1). Producteurs typiques : les [steps Email & SMS](/fr/tests/email-sms) (`SmsCode`, `MailCode`, `MailLink`), les actions de lecture de texte, et vos propres steps **Set variable**.
Choisissez-en une pour enchaîner les steps : naviguez vers le `MailLink` extrait deux steps plus tôt, ou saisissez `SmsCode` dans le champ 2FA.
### Set variable
Le step **Set variable** stocke une valeur de votre choix en cours de test : donnez-lui une valeur et un nom, et il apparaît dans l'onglet Previous steps pour tous les steps suivants. Consultez la [référence Set variable](/fr/tests/actions/web/setvariable) pour le format JSON et les fonctions de template.
### Créer une variable in-test
Une valeur dont vous avez besoin dans plusieurs steps n'est pas obligée de venir d'un step **Set variable**. Ouvrez le sélecteur sur le champ, choisissez **Create in-test variable** en bas de l'onglet Previous steps, et donnez-lui un nom. La variable arrive dans le champ sous forme de pastille, et c'est à vous de renseigner sa valeur dans l'onglet Environment ou dans l'onglet Variables du step.
Sa valeur peut être aussi riche que n'importe quel autre champ : du texte littéral, une variable globale, un aléatoire intégré, ou une autre variable de test.
## Données aléatoires
L'onglet **Random** génère des données fictives à chaque exécution, pour que chaque lancement utilise des valeurs nouvelles. Préréglages : **First name**, **Last name**, **City** et **Street address**.
**Custom** ouvre un générateur de format quand les préréglages ne conviennent pas :
- **Text** : choisissez les jeux de caractères et la longueur.
- **Number** : générez une valeur numérique.
- **Date** : choisissez le format, `DD/MM/YYYY`, `MM/DD/YYYY`, `DD/MM`, `MM/DD` ou `M, D Y`, avec des contraintes optionnelles.
## Variables configurées
L'onglet **Variables** expose ce qui est défini dans les [Configurations](/fr/tests/configurations) de votre produit : des variables simples et des groupes de variables que vous pouvez développer pour sélectionner une entrée spécifique (comme un `PASSWORD` dans votre groupe par défaut). Définissez une fois, réutilisez dans tous vos tests.
## Modifier et relire dans l'onglet Environment
L'onglet **Environment** du builder rassemble les variables utilisées par votre test, en trois tableaux :
- **Test variables** : tout ce qui est déclaré dans le test (codes extraits, steps Set variable, variables in-test). La colonne **Value** est modifiable, et une modification reste synchronisée avec le step Set variable qui déclare la variable : plus besoin de retrouver le step pour changer une valeur.
- **Global variables** : les variables configurées référencées par le test, avec les valeurs secrètes masquées.
- **Variable groups** : les groupes référencés par le test, et la variante utilisée.
Les mêmes trois tableaux se retrouvent dans l'onglet **Variables** d'un step, réduits à ce que ce step utilise.
Modifier une valeur ici change le test, pas seulement la prochaine exécution : le bouton **Run** devient donc **Save and run**.
Les variables assignées par le script d'un [custom step](/fr/tests/actions/web/customstep) (`test.variables.set`) n'apparaissent pas dans ces tableaux. Leur valeur n'existe que pendant l'exécution, et le script écraserait de toute façon ce que vous auriez saisi ici.
## Surcharger des valeurs pour une exécution
Le test porte les valeurs avec lesquelles il tourne d'habitude. Partout où un test est lancé, ces valeurs peuvent être remplacées sans toucher au test :
- **[Exécuter un test](/fr/executions/run)** : dépliez le test dans le drawer de lancement et modifiez ses variables pour cette exécution seulement.
- **[Créer un monitor](/fr/monitoring/create)** : le formulaire du monitor demande les valeurs qu'il utilisera à chaque exécution planifiée.
- **[Test campaigns](/fr/tests/suites)** : les surcharges sont enregistrées sur la campaign, affichées en pastilles sur les lignes de test, et réutilisées à chaque exécution de la campaign.
Une surcharge ne se limite pas à du texte : elle accepte aussi des références à des variables globales et des aléatoires intégrés, donc un monitor peut relancer le même test avec une adresse email neuve à chaque fois.
## Dans les résultats
La page de résultat d'une exécution comporte un onglet **Variables** qui liste ce qui est entré et ce qui en est sorti, et la modale de résultat d'un monitor aussi. Les valeurs construites à partir de variables et d'aléatoires y sont rendues avec les mêmes pastilles que dans l'éditeur : les entrées d'une exécution se lisent exactement comme le test qui les a produites.
## Et ensuite ?
Définissez les variables, groupes et variantes au niveau produit
Les steps qui alimentent vos variables en codes et liens
Là où les steps, checks et variables se rejoignent
Remplacez les variables et variantes au moment de l'exécution
Créez, listez et mettez à jour les variables configurées avec ktm