- Installation de Python
- Installer les bibliothèques Selenium avec Python
- Qu'est-ce que le PIP ?
- Télécharger et installer l'IDE Python
- Configuration de Selenium dans PyCharm
- Ajouter des pilotes à PyCharm
- Premier programme utilisant Selenium Python
- Exécution du programme
- FAQ sur Selenium Python
- Conclusion
Dans ce tutoriel Selenium Python, apprenez à coder et à exécuter un script de test Selenium en utilisant le langage de programmation Python dans différents navigateurs web :
Au cours des cinq dernières années, le langage Python a connu une croissance exponentielle dans l'industrie, principalement parce qu'il est simple et facile à apprendre. Selenium est l'un des outils de test d'automatisation open-source les plus largement utilisés.
Si l'on combine Selenium avec Python, on peut imaginer à quel point un cadre d'automatisation peut devenir robuste.
Dans ce tutoriel, nous allons apprendre à installer Python, à lier les bibliothèques Selenium avec Python, à installer et à configurer l'IDE PyCharm. A la fin de ce tutoriel, vous serez capable de coder et d'exécuter un script de test Selenium en utilisant le langage de programmation Python dans différents navigateurs web.
Installation de Python
L'installation de Python est assez simple. Cliquez ici et téléchargez la dernière version. Vous obtiendrez un fichier .exe. Installez-le avec tous les paramètres par défaut.
>>Cliquez ici pour obtenir des détails sur le processus d'installation, étape par étape.
Installer les bibliothèques Selenium avec Python
Lorsque vous installez Python, les bibliothèques Selenium ne sont pas installées par défaut. Mais pour vérifier si les bibliothèques Selenium sont déjà présentes dans votre Python, ouvrez l'invite de commande, naviguez jusqu'au chemin où vous avez installé Python et tapez " liste des pip "Cette commande permet d'obtenir la liste de toutes les bibliothèques actuellement disponibles dans votre Python.
Qu'est-ce que le PIP ?
PIP signifie Preferred Installer Program (programme d'installation préféré). Il s'agit d'un gestionnaire de paquets populaire utilisé pour installer des paquets de logiciels écrits en Python. PIP est installé par défaut avec Python. Maintenant, pour lier/installer toutes les bibliothèques Selenium requises avec Python, nous devons exécuter la commande suivante
pip install Selenium
Une fois la commande exécutée, les bibliothèques Selenium seront téléchargées et installées.
Vérifiez maintenant les bibliothèques Selenium à l'aide de l'option liste des pip commande.
Télécharger et installer l'IDE Python
Pour écrire et exécuter des scripts ou des programmes, nous avons besoin d'un IDE. Le choix de celui-ci devient donc très important. PyCharm est l'un des IDE les plus appréciés, en particulier pour le langage Python. Pour télécharger PyCharm, cliquez ici et téléchargez l'édition communautaire qui est gratuite et open source.
Vous obtiendrez un fichier .exe que vous pourrez installer avec tous les paramètres par défaut.
Configuration de Selenium dans PyCharm
Une fois l'installation réussie, allez dans le moteur de recherche de Windows et tapez PyCharm. Vous devriez voir PyCharm community edition comme le montre l'image ci-dessous. Cliquez dessus pour ouvrir PyCharm.
Avant d'écrire le moindre code, nous devons d'abord configurer les bibliothèques Selenium dans PyCharm.
Il y a 2 façons de configurer Selenium pour un projet dans PyCharm. Il s'agit des éléments suivants :
#1) Utiliser l'option Packages disponible dans PyCharm.
Lorsque vous ouvrez PyCharm pour la première fois, vous êtes dirigé vers la fenêtre Créer un nouveau projet.
Cliquez sur Créer un nouveau projet. Par défaut, le nom du projet est sans titre. Saisissez un nom de projet approprié. Cliquez sur Créer.
Remarque : Vous pouvez modifier l'emplacement du projet.
Votre projet sera créé avec succès. Pour vérifier si les bibliothèques Selenium sont configurées, allez à Fichier -> ; Paramètres Dans la page de configuration, cliquez sur Projet -> ; Interprète de projet .
Dans la section des paquets, vous devriez voir le paquet Selenium. S'il n'y en a pas, cliquez sur le bouton " + "Sous les paquets disponibles, recherchez Selenium et cliquez sur Installer le paquet. Vérifiez maintenant que le paquet Selenium est installé.
#2) Utilisation de l'option Inherit from global site-packages
Cette méthode est relativement simple. Fichier-> ; Nouveau projet Lors de la création d'un nouveau projet, sélectionnez l'option " Hériter des packs de sites globaux "Une fois le projet créé, naviguez jusqu'à Fichier -> ; Paramètres-> ; Projet -> ; Interprète de projet , vous pourrez voir que le paquet Selenium est déjà installé.
Ajouter des pilotes à PyCharm
Pour automatiser une application web, nous avons besoin d'un navigateur web et pour indiquer sur quel navigateur exécuter les scripts, nous avons besoin de pilotes pour ce navigateur particulier. Tous les pilotes de navigateurs web sont disponibles ici. Ouvrez la page web et naviguez jusqu'à Navigateurs.
Cliquez sur la documentation pour les navigateurs requis et sélectionnez la version stable du pilote.
Pour télécharger Chrome Pour télécharger le fichier zip correspondant à votre système d'exploitation, vous devez vous rendre dans la documentation de Chrome et cliquer sur "Current stable release" dans la rubrique "All versions available in Downloads".
Exemple : "Chromedriver_win32.zip". pour Windows.
Pour télécharger Firefox : Naviguez vers la documentation de Firefox, cliquez sur geckodriver releases et faites défiler pour trouver les pilotes pour tous les systèmes d'exploitation.
Exemple : pour Windows 64, sélectionnez geckodriver-v0.26.0-win64.zip.
Pour télécharger Microsoft Edge : Naviguez vers la documentation Edge, ce qui ouvrira directement la page du pilote sous Téléchargements. Exemple : x64 pour Windows 64 bit OS
Premier programme utilisant Selenium Python
PyCharm est maintenant prêt à accepter et exécuter le code Selenium. Pour être bien organisé, nous allons créer 2 répertoires (un répertoire est similaire à un dossier). Nous utiliserons un répertoire pour placer tous les scripts de test, appelons-le "Main" et l'autre répertoire pour placer tous les pilotes du navigateur web, appelons-le "Driver".
Cliquez avec le bouton droit de la souris sur le projet et créez un nouveau répertoire comme indiqué dans l'image ci-dessous :
Dans le répertoire principal, créez un nouveau fichier Python, ce qui créera un fichier .py et ouvrira l'éditeur.
Copiez ensuite le pilote .exe extrait, pour exemple, Chromedriver.exe et collez le fichier dans le répertoire Drivers.
Nous sommes maintenant prêts à écrire notre premier code d'automatisation en utilisant Selenium Webdriver avec Python.
Définissons d'abord les étapes à franchir grâce à l'automatisation dans le tableau ci-dessous.
| Étape | Action | Résultat attendu |
|---|---|---|
| 1 | Ouvrir le navigateur Chrome | Le navigateur Chrome devrait se lancer avec succès |
| 2 | Naviguez vers www.google.com | La page web de Google doit être ouverte |
| 3 | Agrandir la fenêtre du navigateur | La fenêtre du navigateur doit être maximisée |
| 4 | Saisir l'identifiant LinkedIn dans le champ de texte Google | Le texte correct doit être saisi |
| 5 | Appuyer sur la touche Entrée | La page de recherche doit s'afficher avec les bons résultats |
| 6 | Cliquez sur l'URL de connexion LinkedIn | La page de connexion LinkedIn doit s'afficher |
| 7 | Saisir le nom d'utilisateur et le mot de passe | Le nom d'utilisateur et le mot de passe doivent être acceptés |
| 8 | Cliquez sur le bouton Login | La page d'accueil de LinkedIn doit être affichée |
| 9 | Vérifier le titre de la page | LinkedIn doit être affiché sur la console |
| 10 | Vérifier l'URL actuelle de la page | //www.linkedin.com/feed/ doit être affiché sur la console |
| 11 | Fermer le navigateur | La fenêtre du navigateur doit être fermée |
Pour réaliser le scénario mentionné ci-dessus, nous utiliserons certaines des commandes Selenium Python fréquemment utilisées.
Selenium.Webdriver fournit toutes les implémentations de Webdriver. Nous devons donc indiquer à Python d'importer Webdriver depuis Selenium. La classe Keys nous permet d'utiliser les touches du clavier comme ENTER, ALT, etc.
from selenium import Webdriver from selenium.webdriver.common.keys import Keys
#1) Ouvrir le navigateur Chrome
Pour ouvrir un navigateur, nous devons créer une instance de ce navigateur particulier. Dans cet exemple, nous allons créer une instance de Chrome Webdriver et indiquer l'emplacement de Chromedriver.exe. Il y a peu, nous avons téléchargé et extrait tous les pilotes de navigateur et les avons placés dans le répertoire Driver de notre PyCharm.
Cliquez avec le bouton droit de la souris sur l'icône Chromedriver.exe et Copier le chemin absolu et collez la commande Webdriver comme indiqué ci-dessous.
driver = Webdriver.chrome("C:\Users\Admin\PyCharmProjects\SeleniumTest\Drivers\chromedriver.exe") #2) Naviguer vers www.google.com
Les driver.get naviguera vers une page mentionnée par l'URL. Vous devez spécifier l'URL complète.
Exemple : //www.google.com
driver.get("//www.google.com/") #3) Agrandir la fenêtre du navigateur
driver.maximize_window maximise la fenêtre du navigateur
driver.maximize_window()
#4) Saisir l'identifiant LinkedIn dans le champ de texte de Google
Pour rechercher le login LinkedIn, nous devons d'abord identifier la boîte de texte de recherche Google. Selenium fournit différentes stratégies pour localiser des éléments sur une page.
>> ; Voir ici pour plus de détails sur les localisateurs Selenium WebDriver.
a) Aller sur le lien
b) Cliquez avec le bouton droit de la souris sur la zone de texte de recherche et sélectionnez inspecter l'élément.
c) Nous avons un champ nom qui a une valeur unique "q". Nous allons donc utiliser la fonction find_element_by_name pour identifier la boîte de texte de recherche.
d) send_keys nous permettra de saisir n'importe quel texte. Exemple : "LinkedIn Login"
e) Allez sur Pycharm et entrez la commande suivante :
driver.find_element_by_name("q").send_keys("LinkedIn Login") #5) Appuyer sur la touche Entrée
Pour accéder à la page des résultats de la recherche, il faut soit cliquer sur le bouton Google Search, soit appuyer sur la touche Entrée du clavier. Dans cet exemple, nous allons voir comment appuyer sur la touche Entrée à l'aide de commandes. Touches.Enter aidera à appuyer sur la touche Entrée du clavier.
driver.find_element_by_name("q").send_keys(Keys.Enter ) #6) Cliquez sur l'URL de connexion LinkedIn
Une fois sur la page de résultats de la recherche, nous devons cliquer sur le lien LinkedIn Login. Nous utiliserons la méthode suivante find_element_by_partial_link_text pour y parvenir.
driver.find_element_by_partial_link_text("LinkedIn Login").click() #7) Saisir le nom d'utilisateur et le mot de passe
Les champs Nom d'utilisateur et Mot de passe ont des valeurs d'identification uniques et utilisent des clés d'envoi pour entrer dans les champs.
driver.find_element_by_id("username").send_keys("enter your username") driver.find_element_by_id("password").send_keys("enter your password") #8) Cliquez sur le bouton Login
La connexion est le seul bouton disponible sur la page. Nous pouvons donc utiliser le localisateur de noms de domaine pour l'identifier. find_element_by_tag_name.
driver.find_element_by_tag_name("button").click() #9) Vérifier le titre de la page
La commande driver.title permet de récupérer le titre de la page et la commande print permet d'imprimer le titre de la page web sur la console. Veillez à utiliser des accolades ().
print(driver.title)
#10) Vérifier l'URL actuelle de la page
Les driver.current_url récupère l'URL de la page. imprimer affichera l'URL actuelle sur la console.
print(driver.current_url)
#11) Fermer le navigateur
Enfin, la fenêtre du navigateur est fermée driver.close .
driver.close()
Le script de test complet est donné ci-dessous :
from selenium import webdriver from selenium.webdriver.common.keys import Keys Import time driver = webdriver.Chrome(r "C:\Users\Admin\PycharmProjects\SeleniumTest\Drivers\chromedriver.exe") driver.get("//www.google.com/") driver.maximize_window() driver.find_element_by_name("q").send_keys("LinkedIn login") driver.find_element_by_name("q").send_keys(Keys.ENTER)driver.find_element_by_partial_link_text("LinkedIn Login").click() driver.find_element_by_id("username").send_keys("enter your username") driver.find_element_by_id("password").send_keys("enter your password") driver.find_element_by_tag_name("button").click() time.sleep(5) print(driver.title) print(driver.current_url) driver.close( Remarque : # est utilisé pour commenter la ligne.
time.sleep(sec) est utilisé pour retarder l'exécution de la ligne suivante.
Exécution du programme
Il existe plusieurs façons d'exécuter le programme
#1) Exécuter avec l'IDE PyCharm
Une fois le codage terminé, il suffit de faire un clic droit sur l'éditeur et de cliquer sur Exécuter "Nom du programme" ou sur la touche de raccourci Ctrl+Shift+F10.
Après l'exécution, le résultat sera affiché dans la console ci-dessous. Exécutons maintenant notre exemple de code et vérifions les résultats.
Erreur de syntaxe - Erreur d'encodage
Après avoir exécuté le code, nous obtenons l'erreur suivante dans la console.
Le problème se situe au niveau du chemin d'accès au pilote Chrome. C:\NUsers\NAdmin\NPyCharmProjects\NSeleniumTest\NDrivers\Nchromedriver.exe
\U dans C:\Users devient un caractère Unicode et \U est donc converti en caractère d'échappement Unicode, ce qui rend le chemin invalide. Il y a deux façons de résoudre ce problème.
#A) Ajouter des barres obliques inverses
driver = Webdriver.chrome("C:\NUsers\NAdmin\NPyCharmProjects\NSeleniumTest\NDrivers\Nchromedriver.exe") #B) Préfixer la chaîne avec r :
La chaîne sera alors traitée comme une chaîne brute et les caractères Unicode ne seront pas pris en compte.
driver = Webdriver.chrome(r "C:\Users\Admin\PyCharmProjects\SeleniumTest\Drivers\Chromedriver.exe")
TypeError : l'objet module n'est pas appelable
Exécutez le code une nouvelle fois. Nous avons maintenant une erreur différente dans la console.
La raison en est que lorsque vous écrivez Webdriver Deux options sont proposées chrome (Selenium Webdriver ) et Chrome (Selenium.Webdriver.Chrome.Webdriver) comme indiqué ci-dessous.
Nous devrions sélectionner Chrome (Selenium.Webdriver.Chrome.Webdriver), si vous sélectionnez la première option, vous obtiendrez l'erreur de la capture d'écran ci-dessus.
Cette fois-ci, le script s'est exécuté avec succès et a imprimé le titre et l'URL actuelle de la page web sur la console.
Remarque : Si vous rencontrez toujours un problème. Essayez la commande suivante :
driver = Webdriver.Chrome(executable_path= "C:\NUsers\NAdmin\NPyCharmProjects\NSeleniumTest\NDrivers\Nchromedriver.exe")
#2) Exécuter le script dans différents navigateurs :
Pour exécuter le même script dans un autre navigateur, il suffit de créer une instance de ce navigateur particulier au lieu de Chrome dans l'exemple de code ci-dessus.
Exemple pour le navigateur Firefox : Remplacez Chrome par Firefox comme indiqué ci-dessous :
driver = Webdriver.Firefox(executable_path="C:\NUsers\NAdmin\NPyCharmProjects\NSeleniumTest\NDrivers\Ngeckodriver.exe")
Pour le navigateur Microsoft Edge, remplacez Chrome par Edge comme indiqué ci-dessous :
driver = Webdriver.Edge(executable_path="C:\NUsers\NAdmin\NPyCharmProjects\NSeleniumTest\NDrivers\NMedgedriver.exe")
#3) Exécuter le script dans l'invite de commande :
Cliquez avec le bouton droit de la souris sur le répertoire où vous avez écrit votre code. Exemple : Main", puis copiez le chemin absolu. Ouvrez l'invite de commande et changez le répertoire en répertoire Python avec la commande "cd" et un clic droit. Une fois le répertoire changé, entrez le "nom du programme" Python.
Python FirstTest.py
Le code sera exécuté et le résultat s'affichera dans l'invite de commande.
FAQ sur Selenium Python
Q #1) A quoi sert Selenium Python ?
Réponse : Un grand nombre de programmeurs ont commencé à utiliser Selenium avec Python pour l'automatisation des tests. Voici quelques-unes de ces raisons :
- Pour les tests d'applications web, Selenium est l'outil d'automatisation le plus utilisé, qui offre diverses fonctions, conçues pour répondre aux exigences des tests d'applications web.
- Le langage Python gagne en popularité car il présente moins de problèmes de syntaxe et peut être codé à l'aide d'un simple mot-clé.
- Selenium envoie des commandes standard de Python à différents navigateurs, quelle que soit la conception de ces derniers.
- La combinaison de Python et de Selenium fournit diverses API qui permettent d'écrire des tests fonctionnels.
- Selenium et Python sont tous deux des logiciels libres, que chacun peut donc télécharger et utiliser dans n'importe quel environnement.
Q #2) Comment ouvrir Chrome dans Selenium Python ?
Réponse : Téléchargez le pilote Chrome à partir d'ici et extrayez le fichier .exe. Spécifiez le chemin complet du fichier .exe lors de la création d'une instance de Chrome Webdriver.
driver = Webdriver.Chrome("C:\NUsers\NAdmin\NPyCharmProjects\NSeleniumTest\NDrivers\NChromedriver.exe") Q #3) Comment corriger l'erreur Unicode dans Python ?
Réponse : Il y a deux façons de résoudre ce problème.
a) Soit il faut ajouter des antislashs supplémentaires
driver = Webdriver.Chrome("C:\NUsers\NAdmin\NPyCharmProjects\NSeleniumTest\NDrivers\NChromedriver.exe") b) Préfixe la chaîne avec r. Cela permet de traiter la chaîne comme une chaîne brute et les caractères Unicode ne sont pas pris en compte.
driver = Webdriver.Chrome(r "C:\Users\Admin\PyCharmProjects\SeleniumTest\Drivers\Chromedriver.exe")
Q #4) Comment faire fonctionner Firefox dans Selenium Python ?
Réponse : Téléchargez le pilote Firefox geckodriver à partir d'ici et extrayez le fichier .exe. Spécifiez le chemin complet du fichier .exe lors de la création d'une instance de Firefox Webdriver.
driver = Webdriver.Firefox(executable_path="C:\NUsers\NAdmin\NPyCharmProjects\NSeleniumTest\NDrivers\Ngeckodriver.exe"). driver.get("//www.google.com") Cela ouvrira la page web de Google dans le navigateur Firefox.
Q #5) Comment obtenir Selenium pour Python ?
Réponse : Après l'installation de Python, ouvrez l'invite de commande et changez le répertoire vers le dossier où Python est présent et exécutez pip install Selenium. Cela ajoutera les dernières bibliothèques Selenium à Python.
C:\NUsers\NAdmin\NAppData\NLocal\NProgrammes\NPython\NPython38-32>pip install Selenium.
Vous trouverez les bibliothèques Selenium dans le dossier Lib\site-packages de Python.
Conclusion
Dans ce tutoriel, nous avons appris les bases nécessaires pour commencer à écrire le script en utilisant Selenium Webdriver et le langage Python. Voici les éléments essentiels de ce tutoriel :
- Python et Selenium se sont avérés être les plus utilisés par les programmeurs, d'où l'existence d'un grand nombre de documents d'aide.
- La liaison des bibliothèques Selenium avec Python peut être réalisée par une simple commande pip install Selenium.
- PyCharm est l'IDE le plus utilisé, en particulier pour le langage Python. L'édition Community est entièrement gratuite. De plus, il dispose d'un grand nombre de paquets qui vous aideront à écrire des tests fonctionnels et l'installation est très facile.
- Nous avons également appris à télécharger différents pilotes de navigateur et à les ajouter aux scripts de test dans PyCharm afin de pouvoir tester notre application dans le navigateur spécifié.
- Nous avons appris différentes commandes Selenium qui nous permettent d'automatiser facilement les fonctionnalités des applications web.
- Nous avons également exécuté le script de test sur l'IDE et l'invite de commande.