In Selenium können die HTML-Elemente auf verschiedenen Wegen lokalisiert werden. Detaillierte Informationen dazu finden sich hier. In der Standardeinstellung nutzt Selenium den id-Lokator, wenn kein explizites Präfix definiert ist. In meinem Projekt haben wir die Anforderung die zu testenden Elemente über den Labeltext zu lokalisieren, da die id- und name-Attribute generiert werden. Das Ziel des eigenen Lokators ist es den Wert des id-Attributes des folgenden Feldes zu ermitteln:
1<label for="IDGEN123456789">Foo-Label</label> 2<input id="IDGEN123456789" value="test"/>
Daniel hat bereits einen sehr guten Artikel über Tipps und Tricks zur Benutzung von Lokatoren und ähnliche Themen in diesem Bereich geschrieben. In diesem Blogartikel möchte ich auf die Erstellung einer eigenen Lokator-Strategie eingehen. Der Hauptgrund für mich war, dass XPath-Ausdrücke in den Testfällen nicht wirklich wartbar sind. Normalerweise möchte ich solche Ausdrücke zum lokalisieren eines Elements in einem Testfall nicht sehen:
1xpath=//label[contains(.,'Foo-Label')]/@for
Ich möchte an dieser Stelle keine Diskussion starten, ob denn jetzt CSS- oder XPath-Lokatoren der bessere Weg sind. In diesem Beispiel wird XPath genutzt. Nach kurzer Recherche fand ich diese nützliche User-Extension. Das ist schon fast alles was wir brauchen, um die Elemente zu lokalisieren. Aber starten wir am Anfang.
Implementierung der Lokator-Strategie für Selenium
Als erste muss eine JavaScript-Datei (user-extension.js) mit der Lokator-Strategie erstellt werden:
1PageBot.prototype.locateElementByLabelText = function(labelText, inDocument) {
2[...]
3}
Das Präfix ist sehr wichtig, da alle locateElementBy*-Methoden als Lokator-Strategie automatisch hinzugefügt werden. Für den vollständigen Quellcode verweise ich an dieser Stelle auf diese Seite.
Um die Erweiterung in den Tests zu nutzen, muss die user-extension.js dem Selenium Server bekannt gemacht werden:
1java -cp selenium-server-standalone-2.16.1.jar org.openqa.selenium.server.SeleniumServer -port 4455 -singlewindow -userExtensions "user-extensions.js"
Nach diesen Schritten ist man in der Lage den neuen Lokator zu benutzen:
1labeltext=Foo-Label
Selenium IDE
Aber es wäre auch noch sehr cool, wenn es möglich wäre diesen Lokator in der Selenium IDE zu nutzen. Kein Problem 🙂 Für dieses Feature ist die Implementierung eines LocatorBuilders notwendig:
1LocatorBuilders.add('labeltext', function(e) {
2 if (e.id) {
3 var locator = "xpath=" + "//" + "label[@for='" + e.id +"']" + "/span/text()";
4 var label = this.findElement(locator);
5 return "labeltext=" + label.textContent;
6 }
7 return null;
8 });
Falls die neue Strategie per default genutzt werden soll, braucht man nur diese Zeile noch ins Skript einfügen:
1LocatorBuilders.order = ['labeltext', 'id', 'link', 'name', 'dom:name', 'xpath:link', 'xpath:img', 'xpath:attributes', 'xpath:href', 'dom:index', 'xpath:position'];
Die obigen Skripte sollten in einer separaten Datei gespeichert werden (z.B. user-extension-ide.js), weil der LocatorBuilder nur in der Selenium IDE benötigt wird.
Installation in der Selenium IDE
Zur Installation braucht man nur die Skripte im Options-Menu, wie auf folgendem Bildschirmfoto, konfigurieren:
Benutzung
Andreas hat hier ein paar Tipps zum debuggen von XPath und CSS Lokatoren gegeben. In seinem Screencast zeigt er die Verwendung des „Find“-Buttons in der Selenium IDE zum lokalisieren von Elementen. Wenn die obigen Skripte korrekt installiert sind, dann ist man in der Lage dieses nützliche Feature auch mit dem neuen „labeltext“-Lokator zu nutzen.
In Kombination mit der Selenium IDE Erweiterung für das Robot Framework ist es möglich die Testfälle aufzuzeichnen und direkt in ein sehr lesbares Format zu exportieren:
1Select From List labeltext=Label1 Test 2Input Text labeltext=Label2 AnotherValue 3Textfield Should Contain labeltext=Label3 Test
Der Quelltext von diesem Beispiel ist auf Github verfügbar.
War dieser Beitrag hilfreich?
Weitere Beiträge
von Dennis Schulte
5.4.2015 Dein Job bei codecentric?
Jobs
Agile Developer und Consultant (w/d/m)
Alle Standorte
Gemeinsam bessere Projekte umsetzen.
Wir helfen deinem Unternehmen.
Du stehst vor einer großen IT-Herausforderung? Wir sorgen für eine maßgeschneiderte Unterstützung. Informiere dich jetzt.
Hilf uns, noch besser zu werden.
Wir sind immer auf der Suche nach neuen Talenten. Auch für dich ist die passende Stelle dabei.
Blog-Autor*in
Dennis Schulte
Du hast noch Fragen zu diesem Thema? Dann sprich mich einfach an.
Du hast noch Fragen zu diesem Thema? Dann sprich mich einfach an.