Comment automatiser les tests du Shadow DOM

Antoine Craske3 min de lecture

Les nouvelles applications réactives sont difficiles à tester.

Sur cette page5
Comment automatiser les tests du Shadow DOM

Les logiciels s’appuient de plus en plus sur des composants, avec des modules indépendants qui réagissent à des événements précis. Cette évolution permet d’enrichir l’expérience utilisateur avec des blocs dynamiques, sans recharger toute la page.

Améliorer l’expérience utilisateur est nécessaire, mais l’implémentation de ces modules pose le problème du Shadow DOM : le code isolé dans un module n’est, par nature, pas visible dans le DOM principal de la page HTML.

Vous pouvez désormais tester les éléments du Shadow DOM depuis Cerberus Testing 4.13, la plateforme open source d’automatisation des tests. La fonctionnalité est intégrée au framework standard pour vous faciliter la tâche.

Cet article explique comment automatiser les tests des éléments du Shadow DOM. Vous pouvez suivre ce tutoriel avec une offre Cerberus Testing gratuite.

Comprendre la génération du Shadow DOM#

Il faut d’abord identifier les éléments qui feront partie de vos tests automatisés. Avec Selenium, vous obtiendrez une « NoSuchElementException » : il vous faut donc une autre solution.

Vous pouvez accéder aux éléments du Shadow DOM en parcourant le code source de la page. Ils se trouvent dans la partie « shadow host », qui renvoie vers le Shadow Tree. C’est votre point de départ pour identifier les autres éléments.

Accéder à l’arborescence des pages testées est indispensable pour identifier les différents localisateurs (locators). Vous pouvez aussi parcourir le code source pour voir comment ils sont générés. Vérifiez que le Shadow DOM que vous voulez tester est en mode « open », car il peut être forcé en mode « closed ».

Vous êtes maintenant prêt à identifier les localisateurs.

Identifier le localisateur de requête du Shadow DOM#

Comme le DOM, les éléments du Shadow DOM sont organisés en arborescence. Pour atteindre ces éléments cachés, il faut un langage qui permette de naviguer dans cette arborescence. Dans Cerberus Testing, une syntaxe simple est disponible dans l’interface utilisateur.

Nous allons utiliser un site d’exemple qui contient du Shadow DOM : Demo Icon Set (s’ouvre dans un nouvel onglet). Cherchons un élément dans le tableau récapitulatif. Une fois l’élément trouvé, nous pouvons composer le localisateur de requête en indiquant le chemin successif qui y mène.

Dans notre cas, l’accès au lien donne la requête suivante : « iron-component-page>>iron-doc-viewer>>a ». Nous pouvons suivre la même logique pour tous les éléments ouverts du DOM afin de constituer notre collection d’objets.

Dernière étape : configurer ces chemins dans vos tests.

Utiliser la nouvelle propriété d’action dans Cerberus Testing#

Cerberus Testing vous permet de configurer différentes typologies de tests dans l’interface web. La structure standard d’un cas de test comprend des actions, des contrôles et des données. Les chemins du Shadow DOM peuvent être configurés dans tout élément qui fait appel à un localisateur.

Vous devez utiliser le mot-clé (s’ouvre dans un nouvel onglet) « querySelector » pour activer la recherche d’éléments du Shadow DOM. Ce mot-clé attend l’arborescence sous forme de requête séparée par « >> ». Dans notre cas, nous indiquons « querySelector=iron-component-page>>iron-doc-viewer>>a ».

Le même mécanisme s’applique à d’autres types d’actions, et même aux contrôles. Seule condition : le localisateur de requête doit être un paramètre valide.

Vous êtes maintenant prêt à exécuter vos tests.

S’appuyer sur le framework pour exécuter vos tests#

Cerberus Testing offre plusieurs façons de lancer des tests automatisés : manuellement depuis l’interface web, via le planificateur intégré ou par les API. À vous de choisir selon votre contexte.

Pour la démonstration, nous avons configuré un test avec le localisateur xpath et un autre avec querySelector. Vous voyez ainsi la légère différence de configuration et constatez quels tests fonctionnent réellement à l’exécution.

Vous êtes maintenant prêt à étendre votre automatisation des tests.

Aller plus loin avec Cerberus Testing, la plateforme open source d’automatisation des tests#

Le Shadow DOM est de plus en plus utilisé dans les applications modernes. Pouvoir en automatiser les tests change la donne pour la livraison logicielle de votre équipe.

Bien mené, cela permet à l’équipe d’accélérer en confiance, avec une fiabilité accrue.

Vous avez besoin de temps pour vous concentrer réellement sur le produit et votre équipe. Nous avons publié Cerberus Testing en open source (s’ouvre dans un nouvel onglet) sous forme de framework en 2013, pour que le plus grand nombre profite d’une solution d’automatisation des tests prête à l’emploi.

Cerberus Testing est aujourd’hui une plateforme d’automatisation des tests qui ne cesse d’étendre ses cas d’usage, ses intégrations et sa facilité d’utilisation. Une seule plateforme vous permet de collaborer avec votre équipe sur les tests web, mobiles, d’API, desktop et de bases de données.

Commencez à faire la différence dès aujourd’hui.

Partager

Tutoriels

Comment créer un pipeline de tests continus avec GitHub Actions

« Pouvez-vous déployer des tests dans la CI/CD en une heure ? » Suivre le rythme des équipes de développement tout en livrant une automatisation des tests réellement utile est un défi quotidien.

Antoine Craske3 min de lecture3 min
Tutoriels

Automatisation des tests mobiles avec Appium, sans coder

Tester une application mobile est pénible. Il faut d’abord trouver un moyen d’exécuter l’application mobile, sur un appareil local ou distant, le plus souvent émulé.

Antoine Craske7 min de lecture7 min