Localisation des éléments Selenium
Dans Selenium, la localisation des éléments est au cœur des tests automatisés et des opérations sur les pages web.
En localisant les éléments, vous pouvez effectuer des opérations telles que cliquer, saisir du texte et obtenir leurs attributs.
Concepts de base de la localisation des éléments
Qu'est-ce que la localisation des éléments ?
La localisation d'éléments désigne le fait de trouver des éléments spécifiques dans une page web par un moyen quelconque (comme des boutons, des champs de saisie, des liens, etc.).
Pourquoi la localisation d'éléments est-elle nécessaire ?
Les opérations automatisées nécessitent de trouver précisément l'élément cible avant d'effectuer les opérations suivantes (comme cliquer, saisir, etc.).
Unicité des éléments localisés.
Assurez-vous que l'élément localisé est unique afin d'éviter d'opérer sur le mauvais élément.
Méthodes de localisation
Selenium fournit plusieurs méthodes de localisation d'éléments, incluant couramment les suivantes :
1. Localiser par ID
Méthode :find_element(By.ID, "id_value")
Description :Localiser par l'attribut id de l'élément.
from selenium.webdriver.common.by import By element = driver.find_element(By.ID, "username")
2. Localiser par Name
Méthode :find_element(By.NAME, "name_value")
Description :Localiser par l'attribut name de l'élément.
element = driver.find_element(By.NAME, "password")
3. Localiser par nom de classe
Méthode :find_element(By.CLASS_NAME, "class_name")
Description :Localiser par l'attribut class de l'élément.
element = driver.find_element(By.CLASS_NAME, "submit-btn")
4. Localiser par nom de balise
Méthode :find_element(By.TAG_NAME, "tag_name")
Description :Localiser par le nom de balise de l'élément (comme <div>, <input>, etc.).
element = driver.find_element(By.TAG_NAME, "input")
5. Localiser par sélecteur CSS
Méthode :find_element(By.CSS_SELECTOR, "css_selector")
Description :Localiser des éléments par sélecteurs CSS.
element = driver.find_element(By.CSS_SELECTOR, "input#username")
6. Localiser par XPath
Méthode :find_element(By.XPATH, "xpath_expression")
Description :Localiser des éléments par des expressions XPath.
element = driver.find_element(By.XPATH, "//input[@id='username']")
7. Localiser par texte du lien
Méthode :find_element(By.LINK_TEXT, "link_text")
Description :Localiser par le contenu textuel du lien (applicable aux balises <a>).
element = driver.find_element(By.LINK_TEXT, "Click Here")
8. Localiser par texte de lien partiel
Méthode :find_element(By.PARTIAL_LINK_TEXT, "partial_link_text")
Description :Localiser par le contenu textuel partiel d'un lien.
element = driver.find_element(By.PARTIAL_LINK_TEXT, "Click")
Bonnes pratiques pour la localisation d'éléments
Prioriser les attributs uniques:
-
Essayez d'utiliser
id、nameet d'autres attributs uniques pour localiser des éléments.
Éviter d'utiliser des attributs dynamiques:
-
Si les attributs d'un élément sont générés dynamiquement (comme des ID aléatoires), évitez d'utiliser directement ces attributs pour la localisation.
Utilisez la localisation relative:
-
Utilisez XPath ou les sélecteurs CSS combinés aux relations hiérarchiques de l'élément pour la localisation.
Ajoutez des mécanismes d'attente:
-
Utilisez des attentes implicites ou des attentes explicites pour vous assurer que les éléments sont entièrement chargés avant d'effectuer des opérations.
Méthodes courantes de localisation d'éléments
Selenium fournit plusieurs méthodes de localisation d'éléments, chacune adaptée à différents scénarios. Voici les méthodes courantes de localisation d'éléments :
1、find_element_by_id
find_element_by_idest en utilisant celui de l'élémentidattribut pour localiser l’élément.idCet attribut est unique en HTML, donc cette méthode est généralement la plus directe et efficace.
Exemple
2、find_element_by_name
find_element_by_nameest en utilisant celui de l'élémentnameattribut pour localiser l’élément.nameCet attribut est très courant dans les éléments de formulaire.
Exemple
3、find_element_by_class_name
find_element_by_class_nameest en utilisant celui de l'élémentclassattribut pour localiser l’élément.classCet attribut est généralement utilisé pour les définitions de style, et plusieurs éléments peuvent partager le mêmeclass。
Exemple
4、 find_element_by_tag_name
find_element_by_tag_namepermet de localiser des éléments par le nom de balise de l'élément. Les noms de balise tels quediv、input、aetc.
Exemple
5、 find_element_by_css_selector
find_element_by_css_selectorpermet de localiser des éléments par des sélecteurs CSS. Les sélecteurs CSS sont très flexibles et peuvent combiner plusieurs conditions.
Exemple
6、 find_element_by_xpath
find_element_by_xpathpermet de localiser des éléments par des expressions XPath. XPath est un langage permettant de localiser des nœuds dans des documents XML, et il est très puissant.
Exemple
7、 find_element_by_link_text
find_element_by_link_textpermet de localiser des éléments par le contenu textuel du lien. Il est adapté pour localiser<a>balises.
Exemple
8、 find_element_by_partial_link_text
find_element_by_partial_link_textpermet de localiser des éléments par le contenu textuel partiel d'un lien. Il est adapté aux scénarios où le texte est long ou nécessite une correspondance partielle.
Exemple
Localisation de plusieurs éléments (find_elements)
Parfois, nous devons localiser plusieurs éléments plutôt qu'un seul élément. Selenium fournitfind_elementsméthode, qui renvoie une liste d'éléments.
Exemple
find_elementsLa méthode est la même que lafind_elementméthode en utilisation, sauf qu'elle renvoie une liste.
Conseils pour localiser des éléments dynamiques
Dans les applications web, les attributs de certains éléments sont générés dynamiquement et changent à chaque fois que la page est actualisée. Lorsque vous traitez de tels éléments dynamiques, vous pouvez utiliser les techniques suivantes :
1. Utiliser des chemins relatifs
Dans les sélecteurs XPath ou CSS, utilisez des chemins relatifs au lieu de chemins absolus. Les chemins relatifs peuvent éviter les échecs de localisation causés par des changements dans les positions des éléments.
Exemple
2. Utiliser la correspondance partielle
Pour les éléments générés dynamiquementidouclass, vous pouvez utiliser la correspondance partielle pour localiser des éléments. Par exemple, utilisez lecontainsfonction.
Exemple
3. Utilisez des mécanismes d'attente
Les éléments dynamiques peuvent ne pas apparaître immédiatement sur la page. Vous pouvez utiliser les mécanismes d'attente de Selenium pour attendre l'apparition des éléments.
Exemple
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
element = WebDriverWait(driver, 10).until(
EC.presence_of_element_located((By.ID, "dynamic_id"))
)
4. Utilisez JavaScript pour la localisation
Dans certains cas, vous pouvez localiser des éléments dynamiques en exécutant JavaScript.
Exemple
Exemple complet
Selenium fournit un riche ensemble de méthodes de localisation d'éléments. Maîtriser ces méthodes peut nous aider à localiser efficacement les éléments de la page.
Pour les éléments dynamiques, l'application flexible de techniques telles que les chemins relatifs, la correspondance partielle, les mécanismes d'attente et la localisation JavaScript peut grandement améliorer la stabilité et la fiabilité des tests automatisés.
Voici un exemple complet montrant comment utiliser plusieurs méthodes de localisation pour trouver des éléments et effectuer des opérations :
Exemple
from selenium.webdriver.common.by import En
from selenium.webdriver.chrome.service import Service as ChromeService
# Démarrer le navigateur
service = ChromeService(executable_path="./chromedriver")
driver = webdriver.Chrome(service=service)
# Ouvrir la page web
driver.get("https://www.example.com")
# Localiser le champ de saisie par ID et saisir le texte
username = driver.find_element(By.ID, "username")
username.send_keys("testuser")
# Localiser le champ de saisie par Name et saisir le texte
password = driver.find_element(By.NAME, "password")
password.send_keys("password123")
# Localiser le bouton par sélecteur CSS et cliquer
submit_button = driver.find_element(By.CSS_SELECTOR, "button.submit-btn")
submit_button.click()
# Localiser le lien par XPath et cliquer
link = driver.find_element(By.XPATH, "//a[text()='Click Here']")
link.click()
# Fermer le navigateur
driver.quit()