In this blog post I will demonstrate how to write and run a simple test using Selenium WebDriver.

This example is written in Java, but WebDriver supports many other programming languages (C#, Python and Ruby).

Download and install Eclipse

Download and install Eclipse. I chose Eclipse IDE for Java EE Developers, but other distributions should work fine, too.

Apache Maven

Apache Maven should come pre-installed with Mac OS X Snow Leopard and Lion. You can test if you have Maven installed by typing the following command in terminal:

mvn -version

The output should be similar to following:

...
Apache Maven 3.0.3 (r1075438; 2011-02-28 19:31:09+0200)
Maven home: /usr/share/maven
...

I do not cover installation of Maven in this blog, but there are plenty of tutorials available for all supported operating systems.

Install m2eclipse

Eclipse does not have integrated Maven support out of the box. To add the support, I am going to use Maven Integration (m2e).

• In Eclipse: Help -> Install New Software…
• Type the following URL in field Work with: http://download.eclipse.org/technology/m2e/releases
• Click Add…
• Give a name for the repository (such as m2eclipse)
• Click OK
• Select the checkbox Maven Integration for Eclipse
• Click Next etc. to move forward and choose to restart Eclipse when prompted

Create a new Maven project

• In Eclipse: File -> New -> Other… -> Maven -> Maven project
• Click: Next, Next, Next
• Type in field Group Id: com.yourcompany.selenium
• Type in field Artifact Id: yourclientprojectname
• Click: Finish

Edit pom.xml

• Update JUnit version to 4.9:

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

• Add Selenium dependency:

  <dependency>
    <groupId>org.seleniumhq.selenium</groupId>
    <artifactId>selenium-java</artifactId>
    <version>2.6.0</version>
  </dependency>
  
  

• Eclipse should detect the pom.xml changes automatically, build the project and download required dependencies
• After the build is finished, there should be selenium*.jar files under Maven Dependencies under the Project Explorer pane

Cleaning up

• Delete example class called AppTest.java under src/test/java

Create a new test class

• Right-click over package com.yourcompany.selenium.yourclientprojectname under src/test/java and select New -> Class
• Type in field Name: WhenSearchingForDrupalUsingGoogleTest
• Click Finish

Implement the test class

Type or paste in the following code:

Run the test

• Using terminal, navigate to your project folder under your workspace folder
• Type in command:

  mvn clean test -Dwebdriver.base.url=http://www.google.com

• You should see compilation messages and finally something resembling the following:

-------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running com.yourcompany.selenium.yourclientprojectname.WhenSearchingForDrupalUsingGoogleTest
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 7.679 sec

Results :

Tests run: 1, Failures: 0, Errors: 0, Skipped: 0

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------

If everything went well, there should exist a file named screenshot.png at the root of your project folder. If there were errors, you can go and find more information under target/surefire-reports.