Execution

L'exécution des tests se déroule via les fichiers bat généré par le TextEngine (cf. Execution en ligne de commande). Vous les trouverez dans le dossier Batfiles.

Plan de test Kalios

Si vous exécutez un plan de test Kalios, il est important de passer la variable Percy à 1 dans le fichier Config.

Votre test doit contenir l'action VisualTesting dont vous pouvez retrouver la documentation.

Librairie Kalios

Si vous souhaitez faire un test visuel en utilisant uniquement la librairie Kalios, il suffit d'utiliser l'action VisualTesting et d'appeler getPercyResult() à la fin de votre programme pour alerter Percy que le test est fini.

Exemple :

public static void main(String[] args) throws IOException, InterruptedException {
    TextEngine.initWeb("https://magento.softwaretestingboard.com/", "parcours_magento");
    TextEngine.hoverbytext("Women");
    TextEngine.hoverbytext("Tops");
    TextEngine.clickbytext("Jacket");
    TextEngine.visualtesting("", "Tops-Jackets");
    TextEngine.close("");
    TextEngine.getPercyResult();
}

Étapes d'exécution

1. Définir le Token Percy :

   Dans l'invite de commandes (CMD), vous devez d'abord configurer le token Percy en tant que variable d'environnement pour l'authentification.

   Utilisez la commande suivante pour définir le token :

   set PERCY_TOKEN=<votre_token_de_projet>

   Remplacez <votre_token_de_projet> par le token que vous avez obtenu depuis l'interface Percy.

2. Exécuter votre test avec Percy CLI :

   Une fois le token défini, vous pouvez exécuter votre test avec la commande suivante, en utilisant le fichier .bat contenant vos tests :

   npx percy exec -- <nom_du_fichier_test>.bat

   Remplacez <nom_du_fichier_test>.bat par le nom de votre fichier bat contenant les commandes pour exécuter vos tests. Par exemple, si votre fichier de test s'appelle run-tests.bat, la commande sera :

   npx percy exec -- run-tests.bat

   Cette commande permettra à Percy d'exécuter les tests dans le fichier batch et de capturer les instantanés visuels tout au long du processus.

3. Vérification des résultats :

   Une fois l'exécution des tests terminée, Percy enverra les captures d'écran à Percy.io pour analyse et comparaison visuelle. Vous pourrez consulter les résultats dans votre tableau de bord Percy.

Exemple complet :

Si votre token Percy est abc123 et votre fichier de test bat s'appelle test-suite.bat, l'exécution se fera comme suit :

set PERCY_TOKEN=abc123
npx percy exec -- test-suite.bat

Cela définira le token d'authentification, puis exécutera vos tests tout en capturant les différences visuelles.