• Chrome: Um den Chrome-Browser zum Testen zu benutzen muss der Chrome-Driver heruntergeladen und installiert werden http://code.google.com/p/chromedriver/downloads/list. Danach muss ein system property mit dem Namen „webdriver.chrome.driver“ auf den Pfad zu dem Treiber gesetzt werden. In Java mit: System.setProperty(„webdriver.chrome.driver“, „/Applications/chromedriver“); Wiki für die Installation:http://code.google.com/p/selenium/wiki/ChromeDriver

• InternetExplorer: Funktioniert nur mit Windows Betriebssystemen! Um den InternetExplorer zum Testen zu benutzen muss der IE-Driver heruntergeladen und installiert werden http://code.google.com/p/selenium/downloads/list. Danach muss ein system property mit dem Namen „webdriver.ie.driver“ auf den Pfad zu dem Treiber gesetzt werden. Für IE 7 oder höher auf Windows Vista oder Windows 7, müssen die Protected Mode settings für jede Zone denselben Wert haben. Der Wert kann an oder aus sein, solange es derselbe für jede Zone ist. Um die Protected Mode settings zu setzen, wähle „Internet Options…“ in dem Tools menu des IEs, und klicke auf das Security tab. Für jede Zone gibt es eine Checkbox am unteren Ende mit der Aufschrift „Enable Protected Mode“. Das Browser zoom level muss außerdem auf 100% gesetzt werden, damit die native mouse events auf die richtigen Koordinaten gesetzt werden können. Mehr Dokumentation gibt es hier.

Wie schreibe ich einen Test?

Ich empfehle für jeden Browsertyp ein eigenes Maven-Projekt anzulegen. Das hat den Vorteil, daß die Tests für jeden Browser einzeln durchgeführt werden können, je nachdem auf welchem Rechner man sich befindet. So sind die InternetExplorer-Tests nur auf Windows-Rechnern abspielbar und es hat auch nicht jeder einen Chrome-Browser installiert.

Selenium-Tests als JUnit-Tests

Die Tests werden in diesem Beispiel als Unit-Tests angelegt. Benutzt wird JUnit4. Die Bibliothek kann ebenfalls mit Maven eingebunden werden:

<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.0</version>
<scope>test</scope>
</dependency>

Es wird also ein Paket für zusammengehörige Tests unter src/test/java angelegt. Später kann hier auch eine TestSuite „AllTests“ angelegt werden mit der alle Tests in dem Paket nacheinander abgespielt werden können. Dies ist aber auch mit maven-install möglich. Ein erster Testcase wird angelegt. Zugriff auf die JUnit4-Bibliothek erhält man, indem statt des voreingestellten org.junit.Assert-imports ein extends TestCase an die Testklasse geschrieben wird. Damit werden die benötigten Methoden geerbt.

Erzeugen und Zerstören des Browser-Objekts

Als erstes muss ein Browser-Treiber erzeugt werden. Je nachdem welcher Browser zum Testen benutzt werden soll, wird hier der entsprechende Treiber erzeugt. Es ist sinnvoll ein privates Attribut für den Treiber anzulegen und dann den entsprechenden Treiber in einer @Before-Methode zu erzeugen, die vor jedem Test aufgerufen wird.

private WebDriver driver;

@Before
 public void setUp() {
        driver = new FirefoxDriver();
 }

System.setProperty("webdriver.chrome.driver", "/Applications/chromedriver");
driver = new ChromeDriver();

System.setProperty("webdriver.ie.driver",
"/DRIVERS/IEDriverServer/IEDriverServer.exe");
driver = new InternetExplorerDriver();

@After
    public void tearDown() {
        driver.quit();
    }

Als eine weitere Arbeitserleichterung hat es sich erwiesen eine Methode zu haben, die ein bisschen Zeit verstreichen läßt zwischen den einzelnen Aktionen. Da man eine Nutzerinteraktion nachstellt, kann es immer mal wieder eine Weile dauern bis eine Seite geladen ist und bestimmte Elemente auf der Seite sichtbar sind. Dazu kann eine Methode „waitForAwhile()“ implementiert werden, die immer mal wieder während des Testens aufgerufen wird um zu Warten. Bei dem InternetExplorer muss hier mehr Zeit angegeben werden als bei Firefox und Chrome, da er für alles etwas länger braucht.

private void waitForAwhile() {
        try {
            Thread.sleep(5 * 1000);
        } catch (InterruptedException ex) {
            System.out.println("Timeout after waiting 5 seconds.");
        }
}

Danach kann die eigentliche Testmethode geschrieben werden.

Zunächst wird dem Browser-Treiber eine URL für eine Webseite mitgegeben, die getestet werden soll und direkt im Anschluss sollte die Wartemethode aufgerufen werden, da es eine Weile dauert bis der Browser gestartet und die Seite aufgerufen ist.

driver.get("http://seleniumhq.org");

waitForAwhile();

Auswahl von Elementen auf der Webseite

Jetzt können verschiedene Elemente der Seite angesteuert und bedient oder überprüft werden. Für die Auswahl der Elemente auf der Seite gibt es mehrere Möglichkeiten: nach ID, Name, Linktext, Klassenname, per CSS-Selektor oder xpath. Es kann ein einzelnes oder eine Liste von Elementen geholt werden mit findElement() oder findElements().

• WebElement element = driver.findElement(By.id("eindeutige_id"));
• WebElement element = driver.findElement(By.name("name"));
• WebElement element = driver.findElement(By.tagName("tagname"));
• WebElement element = driver.findElement(By.className("classname"));
• WebElement element = driver.findElement(By.linkText("linktext"));
• WebElement element = driver.findElement(By.partialLinkText("part of link"));
• WebElement element = driver.findElement(By.cssSelector("div#id");
• List<WebElement> inputs = driver.findElements(By.xpath("//input"));

CSS-Selektoren

Da ich sehr lange gebraucht habe, um die richtigen CSS-Selektoren anzugeben, hier ein kurzer Hinweis:

Der Pfad zu einem CSS-Element baut sich so auf, daß zunächst ein Element mit einer eindeutigen ID herangezogen wird und dann die Unterelemente, die keine ID haben über die Klassennamen angesprochen werden. Dies sieht wie folgt aus:

driver.findElement(By.cssSelector("div#id >div.classname >div.classname input.classname");

• Hierarchie mit direct child: div#id >div.classname
• wenn nur ein Leerzeichen dazwischen ist, nimmt es ein child oder subchild: div#id div.classname

Man kann auch ein Unterelement einer Liste von Elementen nur durch Nummerierung ansprechen, ohne den Klassennamen, mit

• div:nth-of-type(3) oder
• li:nth-child(2)

Aber woher weiß ich wie die Elemente heißen?

Wenn die Webseite nicht selbst programmiert wurde, kann man das natürlich nicht wissen. Die einfachste Methode das herauszufinden ist den Firebug zu benutzen und die Seite zu untersuchen.

Welche Methoden auf den Elementen ausführbar sind, läßt sich in der Selenium-Java-Api nachlesen oder einfach in Eclipse den Punkt nach dem WebElement eingeben  und schauen was einem an Methoden so angeboten wird.

Komplettes Beispiel für einen Selenium-Test zum selbst ausprobieren

Einfach ein Maven-Projekt anlegen wie oben erklärt, und den Test als JUnit-Test unter src/test/java einfügen. Dann mit RUN AS -> JUnit Test ausführen.

Downloads:

Selenium_Example.docx

Selenium_Example.pdf

Wie das Ganze dann aussieht, zeigt dieses Video:

http://www.youtube.com/watch?v=_lFcwZOnp2s?rel=0