Génération des tests de vues
Génération des tests de vues
La génération des vues permet également de générer automatiquement des fichiers de tests pour les vues React.
Ces tests sont générés à partir des données déclarées dans les fichiers de configuration YAML des vues.
Ils permettent notamment de vérifier :
- le rendu des composants ;
- le bon chargement des données ;
- l’intégration avec les providers de test du projet ;
- certaines interactions utilisateur ;
- le déclenchement de mutations GraphQL.
Principe général
Pour chaque fichier de vue généré, OIP Views Generator peut générer un fichier de test associé.
Le fichier de test suit généralement le format suivant :
Ce fichier peut contenir tout ou partie des tests associés à la vue.
Selon les besoins du projet, les tests peuvent également être découpés en plusieurs fichiers afin de les organiser par domaine fonctionnel.
Exemples :
- tests d’affichage ;
- tests d’actions utilisateur ;
- tests de mutations GraphQL ;
- tests spécifiques à un parcours métier.
Génération automatique
La génération des fichiers de tests est activée par défaut via l’option --gen-test-files de la commande views generate.
Par défaut, l’option suivante est active :
Il est possible de désactiver globalement la génération des fichiers de tests avec l’option suivante :
Mise à jour des tests générés
Lorsqu’un fichier YAML de configuration de vue est modifié, le fichier de test associé peut ne plus être cohérent avec la nouvelle configuration.
Dans ce cas, il est recommandé de supprimer le fichier de test généré avant de relancer la génération des vues.
Exemple :
ou :
Cette suppression permet de régénérer un fichier de test aligné avec la nouvelle configuration de la vue.
Tests générés par défaut
Plusieurs tests peuvent être générés par défaut.
Certains tests sont volontairement marqués comme skip afin de ne pas casser l’existant lors de la génération.
Ces tests peuvent ensuite être activés, complétés ou adaptés par l’équipe projet selon les besoins.
Désactiver la génération d’un test pour une vue
À partir de la version 2.1.0, il est possible de désactiver la génération du fichier de test d’intégration pour une vue spécifique.
Pour cela, il faut ajouter la clé testFile dans le fichier de configuration YAML de la vue et définir sa valeur à false.
Exemple
Lorsque testFile est défini à false, aucun fichier de test d’intégration n’est généré pour la vue concernée.
Remarques
Les fichiers de tests générés constituent une base de travail.
Ils doivent être complétés par l’équipe projet lorsque les données mockées, les interactions utilisateur ou les comportements attendus ne peuvent pas être déduits automatiquement à partir du fichier YAML.
Il est recommandé de conserver les tests simples, lisibles et alignés avec les cas fonctionnels réellement portés par la vue.