HOWTO · Python
Element anhand von Text mit Selenium in Python finden
Dieses Tutorial zeigt, wie Sie mit Selenium in Python Elemente anhand ihres Textes finden. Lernen Sie verschiedene Methoden kennen, darunter XPath, CSS-Selektoren und Linktext-Techniken, um Ihre Fähigkeiten in der Webautomatisierung zu verbessern. Dieser Leitfaden eignet sich für Anfänger wie erfahrene Entwickler gleichermaßen und bietet praktische Beispiele und klare Erklärungen, die Ihnen helfen, effizient durch komplexe Webseiten zu navigieren.
Auf dieser Seite
Der By.XPATH-Locator von Selenium ist die allgemeine Wahl, um ein Seitenelement anhand seines sichtbaren Textes zu finden. Verwenden Sie Linktext-Locators für Anker; CSS-Selektoren allein können keinen Text abgleichen, kombinieren Sie daher bei Bedarf eine CSS-Auswahl mit einer Textprüfung. Die folgenden Locator-Snippets verwenden Selenium-4-APIs. Browserbeispiele erfordern Selenium und einen konfigurierten Browser-Treiber; das eigenständige Python-Beispiel demonstriert den exakten Textabgleich ohne diese externen Abhängigkeiten.
Methode 1: XPath verwenden, um ein Element anhand von Text zu finden
Verwenden Sie //*[text()='About Us'], wenn das Ziel ein direkter Textknoten ist. Für Text, der zusätzliche Leerzeichen oder verschachtelte Elemente enthalten kann, vergleicht //*[normalize-space(.)='About Us'] den kombinierten Text aller Nachfahren des Elements nach dem Kürzen und Zusammenfassen von Leerzeichen. Schränken Sie das Tag oder die Attribute ein, wenn mehrere Elemente denselben Text enthalten können.
Führen Sie dieses eigenständige Beispiel zum Textabgleich aus:
from html.parser import HTMLParser
class LinkTextParser(HTMLParser):
def __init__(self):
super().__init__()
self.in_link = False
self.links = []
def handle_starttag(self, tag, attrs):
if tag == "a":
self.in_link = True
self.links.append("")
def handle_endtag(self, tag):
if tag == "a":
self.in_link = False
def handle_data(self, data):
if self.in_link:
self.links[-1] += data
html = '<a href="#about">About Us</a><a href="#help">Help</a>'
parser = LinkTextParser()
parser.feed(html)
matches = [link.strip() for link in parser.links if link.strip() == "About Us"]
print(matches[0])
About Us
Dieses Beispiel zeigt den Textvergleich an einer festen HTML-Zeichenkette; es steuert keinen Browser. Warten Sie in Selenium auf das Ziel, wenn die Seite es asynchron rendert, zum Beispiel mit WebDriverWait(driver, 10).until(EC.visibility_of_element_located((By.XPATH, "//*[normalize-space(.)='About Us']"))). Schließen Sie den Treiber in einem finally-Block, damit die Bereinigung auch dann erfolgt, wenn eine Suche fehlschlägt.
Methode 2: CSS-Selektoren verwenden, um ein Element anhand von Text zu finden
CSS hat keinen Standard-Selektor für sichtbaren Text. Wählen Sie zuerst eine kleine, relevante Menge von Kandidaten aus und vergleichen Sie dann deren Text im Browser. Wählen Sie beispielsweise Schaltflächen mit document.querySelectorAll('button.action') aus und finden Sie diejenige, deren textContent.trim() mit der gewünschten Beschriftung übereinstimmt. Eine breite Abfrage kann sowohl einen Container als auch dessen Kind treffen, und textContent umfasst auch verborgenen Text von Nachfahren; verwenden Sie daher einen spezifischen Selektor und prüfen Sie die Sichtbarkeit, wenn diese Unterscheidungen wichtig sind. Selenium kann diese Prüfung mit driver.execute_script(...) ausführen; warten Sie auf den relevanten Container, bevor Sie dynamische Inhalte abfragen.
Methode 3: Linktext und teilweiser Linktext
Für Ankerelemente bietet Selenium By.LINK_TEXT und By.PARTIAL_LINK_TEXT. Zum Beispiel findet driver.find_element(By.LINK_TEXT, "Python documentation") eine exakte Linkbeschriftung, während driver.find_element(By.PARTIAL_LINK_TEXT, "Python guide") einen Link findet, der diese Phrase enthält. Diese Locators gelten nicht für Schaltflächen, Überschriften oder andere Elementtypen. Verwenden Sie ein explizites Warten, wenn der Link erst nach dem ersten Laden der Seite hinzugefügt wird, und bevorzugen Sie exakten Text, wenn Links ähnliche Beschriftungen haben.
Fazit
Wählen Sie XPath für den allgemeinen Textabgleich, insbesondere wenn Leerzeichen oder Elementbeziehungen eine Rolle spielen. CSS kann die Kandidaten eingrenzen, aber ein separater Textvergleich ist erforderlich. Linktext-Locators sind für Anker kompakt. Wenn eine Suche das erwartete Element nicht findet, überprüfen Sie dessen Text und Typ, prüfen Sie, ob mehrere Elemente übereinstimmen, und warten Sie auf clientseitig gerenderte Inhalte, statt sich auf eine feste Verzögerung zu verlassen.
FAQ
-
Wie installiere ich Selenium für Python? Installieren Sie das Selenium-Paket mit
python -m pip install selenium. Python enthält seintime-Modul; es ist kein zu installierendes Paket. Die Browsersteuerung erfordert außerdem ein unterstütztes Browser- und Treiber-Setup. -
Welche Browser kann Selenium steuern? Selenium kann gängige Browser wie Chrome, Firefox, Safari und Edge über ihre Browser-Treiber steuern. Die Verfügbarkeit hängt von Ihrem Betriebssystem und dem installierten Browser ab.
-
Kann Selenium im Headless-Modus laufen? Ja. Setzen Sie die Headless-Option des Browsers in seinen Treiber-Optionen, bevor Sie den Treiber erstellen. Auch der Headless-Modus benötigt das Browser- und Treiber-Setup.
-
Wann sollte ich XPath oder CSS verwenden? XPath kann Text abgleichen und Beziehungen im DOM navigieren. CSS wählt nach Element, Klasse und Attributen, hat aber keinen Standard-Textabgleich; fügen Sie bei Bedarf eine separate Textprüfung hinzu.
-
Kann Selenium Single-Page-Anwendungen testen? Ja. Warten Sie auf das erwartete Element oder den erwarteten Zustand, nachdem die Anwendung aktualisiert wurde. Eine erfolgreiche Navigation garantiert nicht, dass clientseitig gerenderte Inhalte bereit sind.