Prérequis :
Projet de test créé
Présentation
Les fichiers de test sont des éléments essentiels dans Thunders qui vous permettent de charger, de gérer et d’utiliser les fichiers nécessaires à l’exécution de vos tests. Ce guide vous explique les opérations de base pour charger, télécharger, modifier et supprimer des fichiers de test.
Importer un fichier de test
Accédez à l'onglet « fichiers de test » dans la barre latérale
Cliquez sur le bouton « Importer un fichier de test »
Attendez que la fenêtre modale s'affiche
Téléchargez votre fichier (ou plusieurs fichiers à la fois) dans la fenêtre modale
Bon à savoir : donnez des noms clairs et descriptifs à vos fichiers de test afin de les identifier facilement.
Ajouter des fichiers téléchargés aux fichiers de test
Lorsqu’un de vos tests télécharge un fichier au cours d’une exécution, vous pouvez enregistrer ce fichier directement dans vos fichiers de test sans avoir à le télécharger sur votre ordinateur puis à le télécharger à nouveau.
Le fichier téléchargé apparaît dans l’étape de test sous la forme d’une variable de fichier mise en évidence (par exemple, [DOWNLOADED_FILE_1]).
Pour enregistrer un fichier téléchargé dans vos fichiers de test :
Ouvrez l'exécution du test et repérez la variable de fichier téléchargé mise en évidence dans l'étape
Passez la souris sur la variable pour afficher son menu
Cliquez sur « Ajouter aux fichiers de test »
Le fichier est ajouté aux fichiers de test de votre projet sous son nom d'origine (par exemple,
sample.csv)
Cette même variable de fichier téléchargé vous permet également :
Télécharger le fichier : enregistrez le fichier sur votre ordinateur
Ouvrir dans un nouvel onglet : prévisualiser le fichier dans un nouvel onglet du navigateur
Les actions « Ajouter aux fichiers de test » et « Télécharger le fichier » s'affichent également lorsque vous cliquez avec le bouton droit de la souris sur la variable.
Ces mêmes actions sont également disponibles depuis la vue d’exécution du test, et pas seulement à partir d’une exécution de test terminée :
Référencer un fichier de test
Pour référencer un fichier de test dans une étape de test :
Accédez à l’éditeur de votre étape de test
Tapez
/fileà l'endroit où vous souhaitez insérer la référence au fichier de testUn sélecteur de fichiers s'affiche, présentant les fichiers de test que vous avez téléversés
Sélectionnez le fichier souhaité dans la liste
La référence du fichier sera automatiquement insérée sous forme de jeton au format suivant :
[FILE_BASENAME_EXT]
Par exemple, si vous sélectionnez un fichier nommé « my_photo.png », il sera inséré sous la forme [FILE_MY_PHOTO_PNG] dans votre étape de test.
Quels types d’assertions peut-on effectuer sur les fichiers de test ?
Après avoir référencé un fichier de test, vous pouvez rédiger des assertions en langage naturel pour le valider.
Voici quelques assertions courantes :
Propriétés du fichier : « La taille du fichier est inférieure à 5 Mo » ou « Le format du fichier est PDF »
Contenu textuel : « Le fichier CSV contient une ligne avec l'adresse e-mail [email protected] » ou « Le fichier JSON possède une propriété 'status' dont la valeur est 'success' »
Contenu visuel : « L'image contient un bouton rouge » ou « La capture d'écran affiche un formulaire de connexion »
Téléchargement d'un fichier de test
Pour télécharger un fichier de test existant :
Recherchez le fichier de test que vous souhaitez télécharger dans la grille
Cliquez sur le menu d’actions représenté par l’icône à trois points dans la colonne Actions
Cliquez sur « Télécharger » dans le menu d’actions
Modification d’un fichier de test
Pour modifier un fichier de test existant :
Recherchez le fichier de test que vous souhaitez modifier dans le tableau
Cliquez sur le menu d'actions représenté par l'icône à trois points dans la colonne Actions
Cliquez sur « Modifier » dans le menu d'actions
Saisissez le nouveau nom de votre fichier de test
Cliquez sur « Mettre à jour » pour enregistrer les modifications
Seul le nom change. L'extension du fichier est fixe et reste affichée à côté du champ. Un nom déjà utilisé par un autre fichier de test du même projet est refusé, car le jeton de référence est construit à partir du nom et deux fichiers ne peuvent pas le partager.
💡 Remarque : si votre fichier de test est déjà référencé dans des cas de test, toutes les références seront automatiquement mises à jour pour utiliser le nouveau nom de fichier.
Suppression d’un fichier de test
Pour supprimer un fichier de test :
Repérez le fichier de test que vous souhaitez supprimer dans la grille
Cliquez sur le menu d'actions représenté par l'icône à trois points dans la colonne Actions
Cliquez sur « Supprimer » dans le menu d’actions
Confirmez la suppression lorsque vous y êtes invité en cliquant à nouveau sur « Supprimer »
Avertissement : la suppression d’un fichier de test est définitive et ne peut pas être annulée. Assurez-vous de vouloir le supprimer avant de confirmer.
Remarque : les fichiers de test référencés dans des cas de test ne peuvent pas être supprimés. Vous devez d’abord supprimer toutes les références au fichier avant de pouvoir le supprimer.
Supprimer plusieurs fichiers de test à la fois
Pour supprimer plusieurs fichiers de test en une seule action :
Sélectionnez les fichiers de test à supprimer à l'aide de la case à cocher de chaque ligne
Cliquez sur Supprimer dans la barre qui apparaît au-dessus de la grille
Confirmez lorsque vous y êtes invité
Une suppression groupée ignore les fichiers référencés par un cas de test au lieu de faire échouer toute l'action. Thunders indique ensuite combien de fichiers ont été supprimés et combien ont été ignorés, ce qui vous permet d'aller retirer les références avant de réessayer. Si tous les fichiers sélectionnés sont référencés, aucun n'est supprimé.
Conseils pour une gestion efficace des fichiers de test
Donnez des noms pertinents à vos fichiers de test afin de pouvoir les identifier facilement par la suite
Passez régulièrement en revue et nettoyez les fichiers de test inutilisés afin de maintenir votre projet bien organisé
Envisagez d’utiliser une convention de nommage cohérente pour les fichiers de test associés
Pour obtenir une assistance supplémentaire ou poser des questions, contactez notre équipe d'assistance à l'adresse [email protected]