Qu'est-ce qu'un script d'initialisation ?
Un script d'initialisation est un extrait de JavaScript qui s'exécute dans le navigateur avant le chargement d'une page, ce qui vous permet de mettre la page dans le bon état avant l'exécution de votre test. Il s'exécute avant chaque page qui s'ouvre dans le navigateur pendant une exécution de test et se configure par environnement (un script sur Staging ne s'exécute que pour Staging par exemple).
Cas d'usage courants :
Contourner un captcha
Forcer l'activation ou la désactivation d'un feature flag
Désactiver l'analytique pour que le trafic de test ne fausse pas vos métriques
Définir les valeurs de fenêtre ou de stockage que l'application lit au démarrage, par exemple pour empêcher l'affichage d'une bannière de cookies ou d'un overlay
Comment ajouter un script d'initialisation
Ouvrez votre projet de test, allez dans Environnements et ouvrez l'environnement à configurer.
Sélectionnez l'onglet Scripts d'initialisation.
Cliquez sur Ajouter un script.
Donnez un nom au script. C'est ainsi que vous le reconnaîtrez par la suite.
Écrivez votre JavaScript dans l'éditeur Script.
Cliquez sur Enregistrer les modifications.
Écrire votre script
L'éditeur de script est un véritable éditeur de code pensé pour le JavaScript :
Coloration syntaxique et numéros de ligne.
Vérification de la syntaxe en direct : le JavaScript invalide est souligné en rouge pendant la saisie, ce qui vous permet de repérer les erreurs avant d'enregistrer.
Un compteur de taille en haut à droite. Chaque script est limité à 10 Ko ; le compteur devient rouge et l'enregistrement est bloqué si vous dépassez cette limite.
Vous pouvez référencer les variables, identifiants et URL d'application de votre environnement directement dans le script grâce à la syntaxe [VARIABLE]. Thunders remplace chaque jeton [VARIABLE] par sa valeur avant l'exécution du script.
Tapez
[dans l'éditeur pour ouvrir la liste d'autocomplétion des variables disponibles.Les variables reconnues sont mises en évidence dans l'éditeur pour les repérer d'un coup d'œil.
Voir les scripts actifs pendant une exécution de test
Lorsque vous exécutez un test sur un environnement comportant un ou plusieurs scripts d'initialisation activés, un badge apparaît en bas de la liste des étapes de test pour indiquer que des scripts d'initialisation sont actifs pour l'environnement sélectionné (par exemple, 1 script d'initialisation actif). C'est un rappel que la page est préparée avant son chargement.
Gérer un script
Activer ou désactiver un script
Chaque script dispose d'un interrupteur Activé sur sa carte. Désactivez-le pour empêcher le script de s'exécuter sans le supprimer. C'est pratique pour désactiver temporairement un comportement. Le badge situé à côté du titre de la liste indique le nombre de scripts actifs, par exemple 1/1 actifs.
Modifier un script
Cliquez sur l'icône modifier (crayon) sur la carte du script, mettez à jour le nom ou le script, puis cliquez sur Enregistrer les modifications.
Supprimer un script
Cliquez sur l'icône supprimer (corbeille) sur la carte du script, puis confirmez dans la fenêtre.