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'utiliserid、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

element = driver.find_element_by_id("element_id")

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

element = driver.find_element_by_name("element_name")

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

element = driver.find_element_by_class_name("element_class")

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

element = driver.find_element_by_tag_name("tag_name")

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

element = driver.find_element_by_css_selector("css_selector")

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

element = driver.find_element_by_xpath("xpath_expression")

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

element = driver.find_element_by_link_text("link_text")

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

element = driver.find_element_by_partial_link_text("partial_link_text")

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

elements = driver.find_elements_by_class_name("element_class")

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

element = driver.find_element_by_xpath("//div[@class='dynamic_class']")

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

element = driver.find_element_by_xpath("//div[contains(@id, 'dynamic_part')]")

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.common.by import En
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

element = driver.execute_script("return document.querySelector('dynamic_selector');")

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 import webdriver
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()
Autres extensions